i18N : client

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 1 minute de lecture

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

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

    i18N - format(Chaîne, message, Carte d’objets)

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

    Tableau 1. Paramètres
    Nom Type Description
    message Chaîne Message d’ajout des jetons.
    carte Objet Carte des paires nom/valeur à remplacer dans le message.
    Tableau 2. Renvoie
    Type Description
    Chaîne La chaîne formatée 
    // 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 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 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é du message demandée et la valeur est la chaîne traduite.
    Tableau 6. Renvoie
    Type Description
    nul