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

Zk calendar3 themes.png


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:


ZK Theme you specified
Calendar Theme
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


Last Update : 2022/01/17

Copyright © Potix Corporation. This article is licensed under GNU Free Documentation License.