Créer des libellés localisés personnalisés
Ce guide vous aidera à créer des libellés localisés personnalisés.
Chemin par défaut des ressources localisées personnalisées
L’approche d’internationalisation d’ARender utilise les fichiers .properties dans lesquels les informations localisables sont stockées.
ARender vous permet de personnaliser des libellés localisés à partir de fichiers de ressources personnalisés externes.
Par défaut, ARender utilise l’ordre suivant pour récupérer les fichiers de ressources personnalisés externes :
- Propriété de configuration
- <HOME_DIR>/ARenderCustomLabels/
- arondor-arender-hmi-spring-boot-2023.6.0.jar\BOOT-INF\classes\labels\
Pour aller plus loin
Définir le chemin de dossier contenant les libellés personnalisés
Pour définir le chemin de dossier où se situent les libellés personnalisés, vous devez modifier la propriété suivante :
# Configuration des libellés ARender
# Définir le chemin où les libellés personnalisés sont stockés
# Sinon laisser vide pour qu'ARender aille chercher dans le <HOME_DIR>/ARenderCustomLabels/ ou dans le dossier labels/
# NB: Assurer que le chemin finisse par un séparateur de fichier, le slash /
arender.server.external.custom.labels.path=
Créez vos propres libellés localisés personnalisés
Les fichiers ressources sont nommés CustomLabels_{lang}.properties, dont lang correspond au code de paramètres régionaux :
- ar (Arabe)
- de (Allemand)
- en (Anglais)
- es (Espagnol)
- fr (Français)
- he (Hébreu)
- it (Italien)
- ja (Japonais)
- pl (Polonais)
- pt (Portuguais)
- pt-BR (Portugais Bresilien)
- ru (Russe)
- zh-CN (Chinois Simplifié)
- zh-TW (Chinois Traditionnel)
Pour chaque langue ou celle nécessaire, stockez les informations localisables sous la forme de paires clé-valeur sensible à la casse.
Pour donner un exemple concret, supposons que vous ayez besoin d’un libellé pour un bouton personnalisé dans 3 langues différentes : anglais, espagnol et français.
Ces fichiers .properties doivent être placés le chemin pré-configuré dans les fichiers de propriétés côté serveur ou dans <HOME_DIR>/ARenderCustomLabels/ ou dans *arondor-arender-hmi-spring-boot-2023.6.0.jar\BOOT-INF\classes\labels*.
hello=Hello World
hello=Hola Mundo
hello=Bonjour le monde
Pour utiliser ce libellé personnalisé, vous devrez le référencer avec le tag customLabels#{label-key}.
Depuis la version 2023.0.0 :
<!-- Sample implementation of a Custom button -->
<bean id="customButton"
class="com.arondor.viewer.client.toppanel.presenter.ButtonPresenter">
<constructor-arg value="customButton"/>
<property name="enabled" value="true" />
<property name="className" value="standardButton icon-arender" />
<property name="buttonTitle">
<value>Custom Button</value>
</property>
<property name="buttonHandler">
<bean class="com.arondor.viewer.client.jsapi.toppanel.JSCallButtonHandler">
<property name="jsCode">
<value>
try
{
alert('Hello world !');
$wnd.getARenderJS().getGenericNotificationJSAPI().askNotification("hello");
alert("Finished !");
}
catch(e)
{
alert("error !" + e);
}
</value>
</property>
</bean>
</property>
</bean>