package"

From Documentation
m
Line 28: Line 28:
 
The [[ZUML Reference/ZUML/Languages|language]] name, such as [[ZUML Reference/ZUML/Languages/ZUL|xul/html]].
 
The [[ZUML Reference/ZUML/Languages|language]] name, such as [[ZUML Reference/ZUML/Languages/ZUL|xul/html]].
  
If omitted, it means it does not belong to a particular language. It is better to specify one if the WPD document defines a [[ZK Developer's Reference/Widget Package Descriptor/widget|widget]].
+
If omitted, it means it does not belong to a particular language. It is better to specify one if the WPD document defines a [[ZK Client-side Reference/Widget Package Descriptor/widget|widget]].
  
 
=depends=
 
=depends=
Line 38: Line 38:
 
  [Optiona][Default: true]
 
  [Optiona][Default: true]
  
It specifies whether the client is allowed to cache the output of this WPD file. By default, it is cacheable since the performance is better. However, you have to turn it off, if you use a [[ZK Developer's Reference/Widget Package Descriptor/function|function]] that will generate the output depending on a varying condition (such as Locale and time zone).
+
It specifies whether the client is allowed to cache the output of this WPD file. By default, it is cacheable since the performance is better. However, you have to turn it off, if you use a [[ZK Client-side Reference/Widget Package Descriptor/function|function]] that will generate the output depending on a varying condition (such as Locale and time zone).
  
 
=Version History=
 
=Version History=

Revision as of 02:01, 3 December 2010

Syntax:

<package name="a_name" [language="a_lang"] [depends="pkg0, pkg1..."] [cacheable="true|false"]>

The root element of a WPD document. It specifies the name of the package, what packages it depends and other information.

Example,

<package name="zul.box" language="xul/html" depends="zul,zul.wgt">
	<script src="Layout.js" jsdoc="true"/>
	
	<widget name="Box"/>
	<widget name="Splitter"/>
	<widget name="Hlayout"/>
	<widget name="Vlayout"/>
</package>

name

[Required]

The package name, such as zul.grid. It has to be unique.

language

[Optional]

The language name, such as xul/html.

If omitted, it means it does not belong to a particular language. It is better to specify one if the WPD document defines a widget.

depends

[Optional]

It specifies a list of packages that this package depends on. In other words, the packages specified in this attribute will be loaded first before loading this package.

cacheable

[Optiona][Default: true]

It specifies whether the client is allowed to cache the output of this WPD file. By default, it is cacheable since the performance is better. However, you have to turn it off, if you use a function that will generate the output depending on a varying condition (such as Locale and time zone).

Version History

Last Update : 2010/12/03


Version Date Content
     



Last Update : 2010/12/03

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