The Library Properties"

From Documentation
 
(10 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 
{{ZKConfigurationReferencePageHeader}}
 
{{ZKConfigurationReferencePageHeader}}
  
Here is a list of supported library properties that ZK recognizes.
+
__TOC__
  
To define a library property, you can configure it in <code>WEB-INF/zk.xml</code><ref>For more information, please refer to [[ZK Configuration Reference/zk.xml/The library-property Element | the library-property element]].
+
Here is a list of supported library properties that ZK supports. There are several different scopes you can configure for a library property. All properties support '''system/application''' scope, but some properties support '''page/component''' scope. Please check each property's page to know its supported scope.
</ref>. For example,
 
  
 +
= System Scope =
 +
If you define a library property as a system property within the configuration file of your web server, though the system property affects the whole system, not just one web application.
 +
 +
= Application Scope =
 +
To make a library property effective for the whole application, configure it in <code>WEB-INF/zk.xml</code>. For more information, please refer to [[ZK Configuration Reference/zk.xml/The library-property Element | zk.xml]].
 +
 +
For example,
 +
 +
'''Single value'''
 
<source lang="xml">
 
<source lang="xml">
 
<library-property>
 
<library-property>
Line 12: Line 20:
 
</library-property>
 
</library-property>
 
</source>
 
</source>
or
+
 
 +
'''Multiple values'''
 
<source lang="xml">
 
<source lang="xml">
 
<library-property>
 
<library-property>
        <name>org.zkoss.bind.proxy.IgnoredProxyClasses</name>
+
<name>org.zkoss.bind.proxy.IgnoredProxyClasses</name>
        <appendable>true</appendable>
+
<appendable>true</appendable>
        <list>
+
<list>
            <value>java.util.Date</value>
+
<value>java.util.Date</value>
            <value>java.sql.Date</value>
+
<value>java.sql.Date</value>
            <value>java.sql.Timestamp</value>
+
<value>java.sql.Timestamp</value>
            <value>java.math.BigDecimal</value>
+
<value>java.math.BigDecimal</value>
            <value>java.math.BigInteger</value>
+
<value>java.math.BigInteger</value>
        </list>
+
</list>
 
</library-property>
 
</library-property>
 
</source>
 
</source>
  
Alternatively, you can define it as a system property with the configuration file of your Web server, though the system property affects the whole system, not just one Web application.
+
 
 +
= Page scope =
 +
Notice that '''not all properties support this scope''', please check each property's page.
 +
Put  <code><custom-attributes></code> in a zul out of any component:
 +
<source lang='xml'>
 +
<custom-attributes org.zkoss.zul.listbox.rod="false"/>
 +
 
 +
<listbox id="box1">
 +
</listbox>
 +
 
 +
<listbox id="box2">
 +
</listbox>
 +
</source>
 +
 
 +
 
 +
= Component Scope =
 +
Notice that '''not all properties support this scope''', please check each property's page.
 +
Put <code><custom-attributes></code> under a specific component:
 +
<source lang='xml'>
 +
 
 +
<listbox>
 +
    <custom-attributes org.zkoss.zul.listbox.rod="false"/>
 +
    ...
 +
</listbox>
 +
</source>
 +
 
 +
 
  
 
{{ZKConfigurationReferenceHeadingToc}}
 
{{ZKConfigurationReferenceHeadingToc}}
  
<blockquote>
 
----
 
<references />
 
</blockquote>
 
 
{{ZKConfigurationReferencePageFooter}}
 
{{ZKConfigurationReferencePageFooter}}

Latest revision as of 09:30, 25 October 2022


The Library Properties


Here is a list of supported library properties that ZK supports. There are several different scopes you can configure for a library property. All properties support system/application scope, but some properties support page/component scope. Please check each property's page to know its supported scope.

System Scope

If you define a library property as a system property within the configuration file of your web server, though the system property affects the whole system, not just one web application.

Application Scope

To make a library property effective for the whole application, configure it in WEB-INF/zk.xml. For more information, please refer to zk.xml.

For example,

Single value

<library-property>
	<name>org.zkoss.zul.Button.mold</name>
	<value>trendy</value>
</library-property>

Multiple values

<library-property>
	<name>org.zkoss.bind.proxy.IgnoredProxyClasses</name>
	<appendable>true</appendable>
	<list>
		<value>java.util.Date</value>
		<value>java.sql.Date</value>
		<value>java.sql.Timestamp</value>
		<value>java.math.BigDecimal</value>
		<value>java.math.BigInteger</value>
	</list>
</library-property>


Page scope

Notice that not all properties support this scope, please check each property's page. Put <custom-attributes> in a zul out of any component:

<custom-attributes org.zkoss.zul.listbox.rod="false"/>

<listbox id="box1">
</listbox>

<listbox id="box2">
</listbox>


Component Scope

Notice that not all properties support this scope, please check each property's page. Put <custom-attributes> under a specific component:

<listbox>
    <custom-attributes org.zkoss.zul.listbox.rod="false"/>
    ...
</listbox>



Subsections:




Last Update : 2022/10/25

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