ZK Developer's Reference/Theming and Styling/ZK Official Themes

Overview

This is an overview of the default themes and applicable add-on themes for each ZK version.

	ZK 6.5	ZK 7.0	ZK 8.0	ZK 8.5
Default Theme	Breeze	Breeze	Breeze	Iceblue
Applicable Themes	Sapphire, Silvertail	Sapphire, Silvertail, Atlantic	Sapphire, Silvertail, Atlantic	Sapphire, Silvertail, Atlantic, ZK Theme Pack (23 Themes)

Installation

1. Download the preferred theme.jar file.
   • Breeze - built-in theme, no need to download and register.
   • Sapphire - from github
   • Silvertail - from github
   • Atlantic - from github
2. Place theme.jar file under "projectName/WEB-INF/lib" folder.
3. Register preferred theme by library property in zk.xml file under "projectName/WEB-INF" folder

<!-- zk.xml -->
<library-property>
    <name>org.zkoss.theme.preferred</name>
    <value>sapphire</value> <!-- or silvertail, atlantic -->
</library-property>

Trendy Design Theme: Breeze, Sapphire, Silvertail

Trendy design emphasizes on gradient background, rounded corners and shadow effects. Breeze is a greyish based theme that supports desktop and tablet, sapphire is a blueish based theme that supports desktop only and silvertail is a silverish based theme that also support desktop only.

See below to take a quick view at the look and feel of Breeze, Sapphire and Silvertail, click image to view original size.

Breeze

Sapphire

Silvertail

Flat Design Theme: Atlantic

On the contrary, flat design replaces skeuomorphism (gradient background, rounded corner and shadow effect) with simplicity and visual clarity to communicate. It is easy to create and customize a new theme based on this design. Atlantic is a blueish based theme that supports both desktop and tablets.

See below to take a quick view at the look and feel of Atlantic, click image to view original size.

Atlantic

Not to Import Google Font

Please refer to ZK Configuration Reference/zk.xml/The Library Properties/org.zkoss.theme.atlantic.useGoogleFont.disabled

ZK Theme Pack

ZK Theme Pack contains 23 modern themes, including lite themes, dark themes and mix-match themes. These themes are designed for ZK 8.5 and later versions and are compatible with ZK 8.5's default Iceblue theme.

Lite themes: Poppy, Marigold, Olive, Aurora, Lavender

Dark themes: Montana, Ruby, Amber, Emerald, Aquamarine, Violet

Mix-match: Cheese and Wine, Winter Spring, Blueberry and Raspberry, Macaron, Deep Sea, Garden Salad, Zen, Mysterious Green, Cardinal, Space Black, Office and Material

Tablet Support

Currently, Breeze and Atlantic themes both supports tablet devices.

Version History

Version	Date	Content