javascript"

From Documentation
m (correct highlight (via JWB))
(6 intermediate revisions by 2 users not shown)
Line 2: Line 2:
  
 
'''Syntax:'''
 
'''Syntax:'''
  <javascript package="''pkg_name''" [merge="'''false'''|true"] [ondemand="'''false'''|true"/>
+
  <javascript package="''pkg_name''" [merge="'''false'''|true"]/>
 +
<javascript package="''pkg_name''" merge="''a_package_to_merge_to''"/>
 +
<javascript package="''pkg_name''" [ondemand="'''false'''|true"/>
 
  <javascript src="''a_uri''"/>
 
  <javascript src="''a_uri''"/>
 
  <javascript>
 
  <javascript>
Line 24: Line 26:
 
  [Optional]
 
  [Optional]
  
It specifies the URI of the JavaScript file to load. The URI could contain <tt>~./</tt> (such as "~./foo/whatever.js") to indicate a JavaScript file should be loaded from the classpath.
+
It specifies the URI of the JavaScript file to load. The URI could contain <code>~./</code> (such as "~./foo/whatever.js") to indicate a JavaScript file should be loaded from the classpath.
  
 
=merge=
 
=merge=
 
  [Optional][Default: false]
 
  [Optional][Default: false]
  
It is used with the <tt>package</tt> attribute to specify whether the package shall be loaded as part of the <tt>zk</tt> package. If not specified, each package will be loaded separatedly. It speed up the loading if we merge several packages into one.
+
It is used with the <code>package</code> attribute to specify whether the package should be loaded as part of the <code>zk</code> package. If not specified, each package will be loaded separatedly. This speeds up the loading if we merge several packages into one.
 +
 
 +
Since ZK 6, it is allowed to specify the target package in the merge attribute. For example,
 +
 
 +
<source lang="xml">
 +
<javascript package="foo.lang" merge="zul.lang"/>
 +
</source>
 +
 
 +
In fact, <code>merge="true"</code> is the same as <code>merge="zk"</code>, i.e., merged to the <code>zk</code> package. Notice that the target package must be a preloaded package. In other words, it must be specified in another <code>javascript</code> element (without the <code>ondemand</code> attribute). In most cases, you shall use <code>zk</code> for packages that can be cached at the client, and use <code>zul.lang</code> for packages that shall  not be cached, such as your own locale-dependent messages.
  
 
For more information, please refer to the [[ZK Developer's Reference/Performance Tips/Minimize Number of JavaScript Files to Load|Performance Tips]] section.
 
For more information, please refer to the [[ZK Developer's Reference/Performance Tips/Minimize Number of JavaScript Files to Load|Performance Tips]] section.
Line 36: Line 46:
 
  [Optional][Default: false]
 
  [Optional][Default: false]
  
It is used to 'cancel' the package specified in another <tt>javascript</tt> element. By default, JavaScript packages are loaded on-demand (i.e., when it is required). By specify &lt;javascript;&gt; in a language definition/addon, we could force some packages to load at the beginning. If you changed the mind, you could either remove  the <tt>javascript</tt> element, or specify another <tt>javascript</tt> element with <code>ondemand="true"</code>.
+
It is used to 'cancel' the package specified in another <code>javascript</code> element. By default, JavaScript packages are loaded on-demand (i.e., when it is required). By specify &lt;javascript;&gt; in a language definition/addon, we could force some packages to load at the beginning. But if you change your mind, you could either remove  the <code>javascript</code> element, or specify another <code>javascript</code> element with <code>ondemand="true"</code>.
  
 
=Version History=
 
=Version History=
Line 43: Line 53:
 
! Version !! Date !! Content
 
! Version !! Date !! Content
 
|-
 
|-
| &nbsp;
+
| 6.0.0
| &nbsp;
+
| September 2011
| &nbsp;
+
| The merge attribute could be specified with the package's name to merge to, such as <code>zul.lang</code>.
 
|}
 
|}
  
 
{{ZKClient-sideReferencePageFooter}}
 
{{ZKClient-sideReferencePageFooter}}

Revision as of 07:44, 18 January 2022


Syntax:

<javascript package="pkg_name" [merge="false|true"]/>
<javascript package="pkg_name" merge="a_package_to_merge_to"/>
<javascript package="pkg_name" [ondemand="false|true"/>
<javascript src="a_uri"/>
<javascript>
js_code
</javascript>

It specifies the JavaScript package or file that has to be loaded to the client. It could also specify the content (the JavaScript code snippet) directly. Notice that, if specified, it is always loaded, no matter if it is required or not.

Example,

<javascript package="zul.box"/>

package

[Optional]

It specifies the package to load.

src

[Optional]

It specifies the URI of the JavaScript file to load. The URI could contain ~./ (such as "~./foo/whatever.js") to indicate a JavaScript file should be loaded from the classpath.

merge

[Optional][Default: false]

It is used with the package attribute to specify whether the package should be loaded as part of the zk package. If not specified, each package will be loaded separatedly. This speeds up the loading if we merge several packages into one.

Since ZK 6, it is allowed to specify the target package in the merge attribute. For example,

<javascript package="foo.lang" merge="zul.lang"/>

In fact, merge="true" is the same as merge="zk", i.e., merged to the zk package. Notice that the target package must be a preloaded package. In other words, it must be specified in another javascript element (without the ondemand attribute). In most cases, you shall use zk for packages that can be cached at the client, and use zul.lang for packages that shall not be cached, such as your own locale-dependent messages.

For more information, please refer to the Performance Tips section.

ondemand

[Optional][Default: false]

It is used to 'cancel' the package specified in another javascript element. By default, JavaScript packages are loaded on-demand (i.e., when it is required). By specify <javascript;> in a language definition/addon, we could force some packages to load at the beginning. But if you change your mind, you could either remove the javascript element, or specify another javascript element with ondemand="true".

Version History

Last Update : 2022/01/18


Version Date Content
6.0.0 September 2011 The merge attribute could be specified with the package's name to merge to, such as zul.lang.



Last Update : 2022/01/18

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