i18N : client

  • Rversion finale: Zurich
  • Mis à jour 31 juil. 2025
  • 1 minute de lecture

    • L’API i18N fournit des méthodes pour obtenir et formater les messages traduits.

    Les méthodes i18N sont accessibles à l’aide de l’objet global g_i18n .

    i18N : format(String, Message, Object map)

    Met en forme une chaîne contenant des jetons nommés avec des valeurs d’une carte.

    Tableau 1. Paramètres
    Nom Type Description
    message Chaîne Message permettant d’ajouter les jetons.
    carte Objet Carte des paires nom/valeur à remplacer dans le message.
    Tableau 2. Renvoie
    Type Description
    Chaîne Chaîne mise en forme 
    // Returns: "The rich young ruler was very very rich"
nowapi.g_i18n.format("The {p1} {p2} {p3} was very very {p1}",{p1: "rich", p2: "young", p3: "ruler"});

    i18N : getMessage(String msgKey, rappel de fonction)

    Récupère un message traduit.

    Si la chaîne spécifiée existe dans la base de données pour la langue actuelle, le message traduit est renvoyé. Si la chaîne spécifiée n’existe pas pour la langue actuelle, la version anglaise de la chaîne est renvoyée. Si la chaîne n’existe pas du tout dans la base de données, l’ID lui-même est renvoyé.

    Tableau 3. Paramètres
    Nom Type Description
    msgKey Chaîne Le message à récupérer.
    rappel Fonction Fonction à appeler lorsque le message a été récupéré. La fonction de rappel a un argument, une chaîne qui est le message traduit.
    Tableau 4. Renvoie
    Type Description
    nul

    i18N - getMessages(Array msgKeys, Rappel de fonction)

    Récupère un ensemble de messages.

    Si la chaîne spécifiée existe dans la base de données pour la langue actuelle, le message traduit est renvoyé. Si la chaîne spécifiée n’existe pas pour la langue actuelle, la version anglaise de la chaîne est renvoyée. Si la chaîne n’existe pas du tout dans la base de données, l’ID lui-même est renvoyé.

    Tableau 5. Paramètres
    Nom Type Description
    Clés msgKeys Tableau Un tableau de clés spécifiant les messages à récupérer.
    rappel Fonction Fonction à appeler lorsque les messages ont été récupérés. La fonction de rappel a un argument, un objet contenant des paires clé-valeur, où la clé est la clé de message demandée et la valeur est la chaîne traduite.
    Tableau 6. Renvoie
    Type Description
    nul