Documentation

La base de connaisance complète sur ARender - Comment l’installer et le configurer pour répondre à vos besoins

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/
  • <TOMCAT_DIR>/webapps/<ARENDER_HMI>/WEB-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 :

arender-server-custom-vanilla.properties
# 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 <TOMCAT_DIR>/webapps/<ARENDER_HMI>/WEB-INF/classes/labels/.

CustomLabels_en.properties
hello=Hello World
CustomLabels_es.properties
hello=Hola Mundo
CustomLabels_fr.properties
hello=Bonjour le monde

Pour utiliser ce libellé personnalisé, vous devrez le référencer avec le tag customLabels#{label-key}.

arender-custom-integration.xml
<!-- Exemple d'implémentation d'un bouton personnalisé -->
<bean id="customButton"
	class="com.arondor.viewer.client.toppanel.presenter.ButtonPresenter">
	<constructor-arg value="customButton"/>
	<property name="enabled" value="true" />
	<property name="imageResource">
		<bean
			class="com.arondor.viewer.client.defferedmodules.ExternalImageResource">
			<property name="width" value="16" />
			<property name="height" value="16" />
			<property name="url" value="http://i86.servimg.com/u/f86/14/46/83/49/biere310.gif" />
		</bean>
	</property>
    <!-- Votre libellé personnalisé -->
	<property name="buttonTitle">
		<ref bean="customLabels#hello" />
	</property>
	<property name="buttonHandler">
		<bean class="com.arondor.viewer.client.jsapi.toppanel.JSCallButtonHandler">
			<property name="jsCode">
				<value>
					<!-- Action JS personnalisée lors d'un événement de click/mouseDown/touch -->
				</value>
			</property>
		</bean>
	</property>
</bean>