The language-config Element"

From Documentation
m
Line 23: Line 23:
 
It specifies the URI of language add-on definitions. To specify more than one URIs, you have to define them with multiple <tt>addon-uri</tt>.
 
It specifies the URI of language add-on definitions. To specify more than one URIs, you have to define them with multiple <tt>addon-uri</tt>.
  
A language addon is used to add new components and override the definitions of existent components. Refer to '''the Component Development Guide'''.
+
A language addon is used to add new components and override the definitions of existent components. Refer to [[ZK Component Development Essentials]] for details.
 +
 
 +
For example,
 +
 
 +
<source lang="xml">
 +
<language-config>
 +
<addon-uri>/WEB-INF/lang-addon.xml</addon-uri>
 +
</language-config>
 +
</source>
 +
 
 +
Then, the content of <tt>lang-addon.xml</tt> could be
 +
 
 +
<source lang="xml">
 +
<language-addon>
 +
<addon-name>FooApplication</addon-name>
 +
<language-name>xul/html</language-name>
 +
</language-addon>
 +
</source>
  
 
==Version History==
 
==Version History==

Revision as of 07:00, 3 August 2010


The language-config Element


The allowed child elements include addon-uri. You might have multiple language-config elements in one zk.xml.


 <language-config>
     <addon-uri>/WEB-INF/lang-addon.xml</addon-uri>
     <addon-uri>/WEB-INF/lang-addon2.xml</addon-uri>
 </language-config>


Note: Unlike most other configurations defined in WEB-INF/zk.xml, the definitions defined in language addons are applied to all Web applications sharing the same zk.jar.

In other words, the definitions in language addons are visible to all Web applications sharing the same zk.jar. Furthermore, it may cause errors in another Web application, if the classes or resources are available only in the Web application defining this.

Thus, if it is an issue, just put zk.jar and relevant ZK libraries under the WEB-INF/lib directory.

The addon-uri Element

[Default: none]

It specifies the URI of language add-on definitions. To specify more than one URIs, you have to define them with multiple addon-uri.

A language addon is used to add new components and override the definitions of existent components. Refer to ZK Component Development Essentials for details.

For example,

	<language-config>
		<addon-uri>/WEB-INF/lang-addon.xml</addon-uri>
	</language-config>

Then, the content of lang-addon.xml could be

<language-addon>
	<addon-name>FooApplication</addon-name>
	<language-name>xul/html</language-name>
</language-addon>

Version History

Version Date Content
     



Last Update : 2010/08/03

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