Skip to content

Internationalisation : textset.js & text()

Les textes de l'appli sont déclarés dans textset.js et lus à l'exécution via le global text() (= kapp.textset.get()), résolus dans la langue du channel.

Déclarer : textset.js

Un objet textset où chaque clé mappe une langue (fr / en) vers une string ou une fonction args => string :

js
const textset = {
    welcome: {
        fr: 'Bienvenue !',
        en: 'Welcome!',
    },
    score: {
        fr: args => `Score : ${args.points}`,
        en: args => `Score: ${args.points}`,
    },
};

infos.json pointe vers ce fichier ("textset": "textset.js"), chargé au démarrage.

Lire : text()

  • text(key: string, args = {}): string — global, raccourci de kapp.textset.get(key, args).
  • Résout dans la langue du channel ; substitue les args (passés à la fonction, ou aux tags #tag# selon la valeur).
js
kapp.display();
document.body.innerHTML = `<h1>${text('welcome')}</h1><p>${text('score', { points: 42 })}</p>`;

Pièges

  • Si la clé est absente, text() renvoie la clé elle-même (pas d'erreur) — vérifie l'orthographe de tes clés.
  • Une valeur peut être une fonction : pense à passer les args attendus.
  • text() / prefs n'existent qu'en appli (pas en widget).