Warning and Error Messages"

From Documentation
m
 
(6 intermediate revisions by one other user not shown)
Line 6: Line 6:
  
 
ZK's system locale dependent messages (such as warnings and errors) are stored in ZK jar with 2 formats:
 
ZK's system locale dependent messages (such as warnings and errors) are stored in ZK jar with 2 formats:
−
# [ZK-JAR]<tt>/metainfo/mesg/*.properties</tt>, Java properties files
+
# [ZK-JAR]<code>/metainfo/mesg/*.properties</code>, Java properties files
 
#:[ZK-JAR] could be zcommon.jar, zweb.jar, zk.jar or zul.jar.
 
#:[ZK-JAR] could be zcommon.jar, zweb.jar, zk.jar or zul.jar.
−
# [zk.jar | zul.jar]<tt>/web/zk/js/lang/*.js</tt>
+
# <code>zk.jar /web/js/zk/lang/*.js</code>
 +
# <code>zul.jar/web/js/zul/lang/*.js</code>
  
−
These files are Locale depedent. For example, the message file in <tt>zk.jar</tt> for Germany messages are
+
These files are Locale depedent. For example, the message file in <code>zk.jar</code> for German messages are
−
* <tt>/metainfo/mesg/msgzk_de.properties</tt>,  
+
* <code>/metainfo/mesg/msgzk_de.properties</code>,  
−
* <tt>/web/js/zk/lang/msgzk_de.js</tt>
+
* <code>/web/js/zk/lang/msgzk_de.js</code>
  
 
= Translate messages to another language =
 
= Translate messages to another language =
  
−
If you want to translate messages to another language, you can add your own property files named with the correct Locale, and put it to the <tt>/metainfo/mesg</tt> directory of the classpath. Of course, it is always better to contribute it back. Please take a look at [[ZK Messages]] for all available translations. If you'd like to contribute, just add the language to it and notice us at info at zkoss dot org.
+
If you want to translate messages to another language, you can add your own property files named with the correct Locale, and put them to the <code>/metainfo/mesg</code> directory of the classpath. Of course, it is always better to contribute back. Please take a look at [[ZK Messages]] for all available translations. If you'd like to contribute, just add the language to it and notify us at info@zkoss.org.
  
 
= Change particular message =
 
= Change particular message =
Line 24: Line 25:
 
{{versionSince| 6.0.0}}
 
{{versionSince| 6.0.0}}
  
−
If you want to change a particular message, you need to create  <tt>WEB-INF/zk-label.properties</tt> (or <tt>WEB-INF/zk-label_[LOCALE].properties</tt>) and add key-value pairs in it. For example, assuming you want to customize <code>MZk.NOT_FOUND</code> in German translation (<tt>msgzk_de.properties</tt>), then you can add the following to <code>WEB-INF/zk-label_de.properties</code>:
+
If you want to change a particular message, you need to create  <code>WEB-INF/zk-label.properties</code> (or <code>WEB-INF/zk-label_[LOCALE].properties</code>) and add key-value pairs in it. For example, assuming you want to customize <code>MZk.NOT_FOUND</code> in German translation (<code>msgzk_de.properties</code>), then you can add the following to <code>WEB-INF/zk-label_de.properties</code>:
  
 
<source lang="xml">
 
<source lang="xml">
Line 30: Line 31:
 
</source>
 
</source>
  
−
Notice the prefix <tt>MZk</tt>, and <tt>3000</tt> is the error code and you can find it at [[ZK_Messages/German/msgzk_de.properties]]
+
Notice the prefix <code>MZk</code>, and <code>3000</code> is the error code and you can find it at [[ZK_Messages/German/msgzk_de.properties]]
  
−
A same pattern applies to the [[ZK_Messages/German | other message files]] such as  
+
The same pattern applies to the [[ZK_Messages/German | other message files]] such as  
−
*<tt>msgzul_de.properties</tt>,
+
 
−
*<tt>msgcommon_de.properties</tt>
+
{|  class="wikitable" | width="100%"
−
*<tt>msgweb_de.properties</tt>.  
+
!  <center>File</center>
−
Where you use the following prefixes to customize a message
+
! <center>Prefix of a Key</center>
−
<source lang="xml">
+
! <center>Key Example</center>
−
MZul.1234=abc
+
|-
−
MCommon.1234=...
+
| msgzk_[LOCALE].properties
−
MWeb.1234=...
+
| <code>MZk</code>
−
</source>
+
| MZk.1000= my text
 +
|-
 +
|msgzul_[LOCALE].properties
 +
| <code>MZul</code>
 +
| MZul.2400=mytext
 +
|-
 +
| msgcommon_[LOCALE].properties
 +
| <code>MCommon</code>
 +
| MCommon.1234= my text
 +
|-
 +
| msgweb_[LOCALE].properties
 +
| <code>MWeb</code>
 +
| MWeb.1234= my test
 +
|}
  
 
== Defined in a JS File ==
 
== Defined in a JS File ==
  
 
=== Using local override===
 
=== Using local override===
−
For messages defined in <tt> msgzk.js / msgzul.js</tt> you can create a js file and include it via <tt>lang-addon.xml</tt>. For example for overriding <tt>msgzk.LOADING</tt> for CEZH language create a file <tt>test_cs.js</tt> and override particular message <code>msgzk.LOADING=CS langauge specific message"</code> and include this js file via <tt>lang-addon.xml</tt> as below
+
For messages defined in <code>msgzk.js / msgzul.js</code> you can create a js file and include it via <code>lang-addon.xml</code>. For example for overriding <code>msgzk.LOADING</code> for CEZH language create a file <code>test_cs.js</code> and override particular message <code>msgzk.LOADING=CS langauge specific message"</code> and include this js file via <code>lang-addon.xml</code> as below
 
<source lang="xml">
 
<source lang="xml">
 
<language-addon>
 
<language-addon>
Line 56: Line 70:
 
</source>
 
</source>
  
−
Note: You can use any prefix other than "test" and add language-specific suffix to your js files and include all of them by using <tt>*</tt> wild card as shown above
+
Note: You can use any prefix other than "test" and add language-specific suffixes to your js files and include all of them by using <code>*</code> wild card as shown above
  
 
Finally include your lang-addon.xml in zk.xml using language-config element as shown below
 
Finally include your lang-addon.xml in zk.xml using language-config element as shown below
Line 75: Line 89:
  
 
=Version History=
 
=Version History=
−
{{LastUpdated}}
+
 
−
{| border='1px' | width="100%"
+
{| class='wikitable' | width="100%"
 
! Version !! Date !! Content
 
! Version !! Date !! Content
 
|-
 
|-

Latest revision as of 03:15, 1 February 2024


DocumentationZK Developer's ReferenceInternationalizationWarning and Error Messages
Warning and Error Messages


Overview

ZK's system locale dependent messages (such as warnings and errors) are stored in ZK jar with 2 formats:

  1. [ZK-JAR]/metainfo/mesg/*.properties, Java properties files
    [ZK-JAR] could be zcommon.jar, zweb.jar, zk.jar or zul.jar.
  2. zk.jar /web/js/zk/lang/*.js
  3. zul.jar/web/js/zul/lang/*.js

These files are Locale depedent. For example, the message file in zk.jar for German messages are

  • /metainfo/mesg/msgzk_de.properties,
  • /web/js/zk/lang/msgzk_de.js

Translate messages to another language

If you want to translate messages to another language, you can add your own property files named with the correct Locale, and put them to the /metainfo/mesg directory of the classpath. Of course, it is always better to contribute back. Please take a look at ZK Messages for all available translations. If you'd like to contribute, just add the language to it and notify us at info@zkoss.org.

Change particular message

Look for the specific message you want to change at ZK Messages first. Then, override it according to the following sections.

Defined in a Properties File

Since 6.0.0

If you want to change a particular message, you need to create WEB-INF/zk-label.properties (or WEB-INF/zk-label_[LOCALE].properties) and add key-value pairs in it. For example, assuming you want to customize MZk.NOT_FOUND in German translation (msgzk_de.properties), then you can add the following to WEB-INF/zk-label_de.properties: 

MZk.3000=my customized message here

Notice the prefix MZk, and 3000 is the error code and you can find it at ZK_Messages/German/msgzk_de.properties

The same pattern applies to the other message files such as

File
Prefix of a Key
Key Example
msgzk_[LOCALE].properties MZk MZk.1000= my text
msgzul_[LOCALE].properties MZul MZul.2400=mytext
msgcommon_[LOCALE].properties MCommon MCommon.1234= my text
msgweb_[LOCALE].properties MWeb MWeb.1234= my test

Defined in a JS File

Using local override

For messages defined in msgzk.js / msgzul.js you can create a js file and include it via lang-addon.xml. For example for overriding msgzk.LOADING for CEZH language create a file test_cs.js and override particular message msgzk.LOADING=CS langauge specific message" and include this js file via lang-addon.xml as below 

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

  <javascript src="/js/test*.js" />
</language-addon>

Note: You can use any prefix other than "test" and add language-specific suffixes to your js files and include all of them by using * wild card as shown above

Finally include your lang-addon.xml in zk.xml using language-config element as shown below 

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

Note: messages updated by a custom javascript will override the default once. If the messages are reloaded using Clients.reloadMessages(Locale), the customization will be lost. To support locale reload, please refer to the next section.

Adding a custom language loader

A custom language loader will find matching messages depending on the user locale, and will be reloaded even if the Clients.reloadMessages(Locale) is triggered.

It can be defined in a language addon using the <message-loader-class> element. Please refer to the client-side reference documentation for more details.

Version History

Version Date Content
6.0.0 n/a Allows applications to override a particular message with zk-label.



Last Update : 2024/02/01

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


Retrieved from "https://www.zkoss.org/_w/index.php?title=ZK_Developer%27s_Reference/Internationalization/Warning_and_Error_Messages&oldid=56701"