Traduction
x4js intègre un système de traduction, appelé i18n (internationalisation).
Le framework a parfois besoin d’afficher des chaînes de caractères : le texte d’un bouton OK, un message de champ obligatoire, le nom des mois. Dans un système multilingue, rien de tout cela n’est écrit en dur.
Quatre langues sont fournies : le français (par défaut), l’anglais, l’espagnol et l’allemand. Vous pouvez ajouter vos propres traductions, modifier celles qui existent, ou créer de nouvelles langues.
Lire une traduction
Section intitulée « Lire une traduction »Tout passe par une variable globale en lecture seule, nommée _tr.
import { _tr } from 'x4js';
console.log( _tr.global.ok );console.log( _tr.global.day_long[0] );Choisir la langue
Section intitulée « Choisir la langue »x4js démarre en français. La langue se choisit ainsi :
import { selectLanguage } from 'x4js';
selectLanguage( "en" );Langue et formats
Section intitulée « Langue et formats »La langue donne aussi le format des nombres, des montants et des dates : formatNumber, formatMoney, formatPercent, formatDate et formatDateTime suivent sa locale ("fr-FR" pour fr, "en-US" pour en). selectLanguage( "en" ) change donc les deux.
import { formatMoney, formatNumber } from 'x4js';
formatNumber( 1234.5 ); // "1 234,5" en françaisformatMoney( 1234.5 ); // "1 234,50 €"Pour imposer une locale et une devise, indépendamment de la langue :
import { Application } from 'x4js';
Application.setLocale( "de-CH", "CHF" );Application.setLocale( null ) revient à la locale de la langue. Les champs de date et le Calendar suivent les formats de la langue (date_format…), pas la locale.
Ajouter vos propres traductions
Section intitulée « Ajouter vos propres traductions »Déclarez un objet de traductions par langue, puis ajoutez-le.
import { _tr, addTranslation, selectLanguage } from 'x4js';
const app_fr = { app: { open: "Ouvrir", close: "Fermer", }};
// même forme que app_fr : le compilateur signale un texte oubliéconst app_en: typeof app_fr = { app: { open: "Open", close: "Close", }};
addTranslation( "fr", app_fr );addTranslation( "en", app_en );
// la langue se choisit après avoir ajouté les traductionsselectLanguage( "en" );L’arborescence peut être aussi profonde que nécessaire, par exemple pour ranger les textes par fonctionnalité.
Garder l’aide à la saisie
Section intitulée « Garder l’aide à la saisie »_tr connaît les textes du framework, pas les vôtres. Pour que l’éditeur propose aussi les textes de l’application, donnez-lui leur forme :
export const tr = _tr as typeof _tr & typeof app_fr;
console.log( tr.app.open );C’est une simple indication de type : tr et _tr sont le même objet.
Ajouter une langue
Section intitulée « Ajouter une langue »import { addTranslation, createLanguage } from 'x4js';
createLanguage( "it", "en" );addTranslation( "it", { app: { open: "Apri", close: "Chiudi" } } );Le second paramètre est la langue de base. Définissez les langues avant toute utilisation.
Une traduction absente dans une langue est cherchée dans sa langue de base, au même endroit. Dans l’exemple, les textes de x4js qui ne sont pas traduits en italien (_tr.global.ok…) s’affichent en anglais. On peut donc traduire progressivement.
Une variante régionale
Section intitulée « Une variante régionale »Une variante régionale est une langue fondée sur une autre, qui ne change que ce qui diffère. Par exemple le français de Suisse, avec ses formats de nombres :
createLanguage( "fr-ch", "fr" );addTranslation( "fr-ch", { global: { locale: "fr-CH" } } );Inspection
Section intitulée « Inspection »import { getAvailableLanguages, getCurrentLanguage } from 'x4js';
console.log( getCurrentLanguage( ) );console.log( getAvailableLanguages( ) );Éléments complexes
Section intitulée « Éléments complexes »Les traductions peuvent contenir des tableaux :
const app_fr = { app: { modes: [ "simple", "normal", "avancé" ], }};La règle
Section intitulée « La règle »Si vous développez des composants, n’écrivez aucun texte en dur. Vous ne savez pas dans quelle langue ils seront utilisés, et il est bien plus simple de le prévoir dès le début que de reprendre tout le code ensuite.