ZK Official Themes"
m (→Installation) |
|||
Line 70: | Line 70: | ||
= Installation = | = Installation = | ||
− | # Download the preferred theme.jar file. | + | # Download the preferred theme.jar file or obtain by maven. |
#* Default theme (Breeze or Iceblue) - built-in theme, no need to download and register. | #* Default theme (Breeze or Iceblue) - built-in theme, no need to download and register. | ||
#* Sapphire, Silvertail, Atlantic - from [http://github.com/zkoss/zkthemes/releases github] | #* Sapphire, Silvertail, Atlantic - from [http://github.com/zkoss/zkthemes/releases github] |
Revision as of 04:35, 30 October 2017
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) |
Trendy Design Themes: 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.
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.
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: 23 themes
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
You can find below some selected screenshots from ZK Theme Pack.
Installation
- Download the preferred theme.jar file or obtain by maven.
- Default theme (Breeze or Iceblue) - built-in theme, no need to download and register.
- Sapphire, Silvertail, Atlantic - from github
- ZK Theme Pack - coming soon
- Place theme.jar file under "projectName/WEB-INF/lib" folder.
- 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>
Manipulating Themes
You can include multiple themes in a same application and allow your end users to choose their preferred themes. For more information please refer to Switching Themes
To build a custom theme based on a standard ZK theme, read Customize a standard theme.
Also reference Theming and Styling.
Version History
Version | Date | Content |
---|---|---|