Themes"
From Documentation
(Created page with "{{ZKCalendarEssentialsPageHeader}} {{versionSince| 3.0.0}} = Overview = <source lang='xml'> <library-property> <name>org.zkoss.calendar.theme.preferred</name> <value>dar...") |
m (replace tt with code (via JWB)) |
||
| (8 intermediate revisions by 2 users not shown) | |||
| Line 4: | Line 4: | ||
= Overview = | = Overview = | ||
| + | There are 4 themes supported: | ||
| + | * iceblue ('''default''') | ||
| + | * breeze | ||
| + | * dark | ||
| + | * wcag | ||
| + | |||
| + | If no configuration specified, ZK Calendar renders in the default theme. | ||
| + | |||
| + | = Look and Feel = | ||
| + | [[File:Zk_calendar3_themes.png | center ]] | ||
| + | |||
| + | |||
| + | |||
| + | = Follow ZK Theme by Default = | ||
| + | By default, Calendars will automatically switch to a theme according to what you specified in the property [[ZK%20Developer's%20Reference/Theming%20and%20Styling/Switching%20Themes | <code>org.zkoss.theme.preferred</code>]]. | ||
| + | |||
| + | Here is the built-in rule: | ||
| + | |||
| + | |||
| + | |||
| + | {| border="1" | width="100%" | ||
| + | ! <center>ZK Theme you specified</center> | ||
| + | ! <center>Calendar Theme</center> | ||
| + | |||
| + | |- | ||
| + | | breeze, silvertail, sapphire | ||
| + | | breeze | ||
| + | |- | ||
| + | | iceblue | ||
| + | | iceblue | ||
| + | |- | ||
| + | | wcag | ||
| + | | wcag | ||
| + | |- | ||
| + | | any dark themes including ruby, amber, emerald, aquamarine, montana, violet and spaceblack, cardinal, mysteriousgreen, zen | ||
| + | | dark | ||
| + | |- | ||
| + | |any other themes not included above | ||
| + | | iceblue | ||
| + | |} | ||
| + | |||
| + | = How to Switch Themes= | ||
| + | Specify one of the following theme names above in <code>zk.xml</code> with the library property below: | ||
<source lang='xml'> | <source lang='xml'> | ||
| Line 13: | Line 56: | ||
</source> | </source> | ||
| + | This component doesn't support switching themes dynamically. You need to modify zk.xml and restart a server to switch a theme. | ||
{{ZKCalendarEssentialsPageFooter}} | {{ZKCalendarEssentialsPageFooter}} | ||
Latest revision as of 09:05, 17 January 2022
Since 3.0.0
Overview
There are 4 themes supported:
- iceblue (default)
- breeze
- dark
- wcag
If no configuration specified, ZK Calendar renders in the default theme.
Look and Feel
Follow ZK Theme by Default
By default, Calendars will automatically switch to a theme according to what you specified in the property org.zkoss.theme.preferred.
Here is the built-in rule:
| breeze, silvertail, sapphire | breeze |
| iceblue | iceblue |
| wcag | wcag |
| any dark themes including ruby, amber, emerald, aquamarine, montana, violet and spaceblack, cardinal, mysteriousgreen, zen | dark |
| any other themes not included above | iceblue |
How to Switch Themes
Specify one of the following theme names above in zk.xml with the library property below:
<library-property>
<name>org.zkoss.calendar.theme.preferred</name>
<value>dark</value>
</library-property>
This component doesn't support switching themes dynamically. You need to modify zk.xml and restart a server to switch a theme.
The example project is at Github