Internationaliser un widget

  • Rversion finale: Zurich
  • Mis à jour 31 juil. 2025
  • 1 minute de lecture
  • Utilisez la syntaxe ${} ou gs.getMessage() dans les champs Modèle HTML, Script client ou Script serveur d’un widget pour baliser les chaînes à traduire afin de pouvoir localiser votre Portail de services contenu.

    Le ${} ou gs.getMessage() recherche dans la table des messages [sys_ui_message] de la plateforme pour voir quelle serait la traduction.

    Utilisez le modèle HTML pour internationaliser les chaînes dans un widget. Tapez ce qui suit dans un modèle HTML.

    <div>
      <p>${This message will be internationalized.}</p>
      <p>However, this will NOT be.</p>
    </div>

    Écrire du texte en tant que ${message} est l’équivalent d’écrire ${gs.getMessage(« message »)} dans d’autres parties du système, mais écrit comme un raccourci plus lisible.

    Remarque :
    Dans certains cas, la traduction peut comporter des guillemets ou des guillemets doubles. Cela peut entraîner des erreurs JavaScript si vous utilisez la syntaxe ${} dans le script client. Le moyen le plus sûr d’extraire un message traduit est de le faire dans le script serveur. Ensuite, affectez la valeur à une liaison Angular côté client.

    Traduction de chaînes dans le script client

    function() {
      var c =this;
      c.message="${This message will be internationalized}";
    }
    Modèle HTML :
    <div>
      <!-- The output of this text will be internationalized. -->
      <p>{{c.message}}</p>
    </div>

    Traduction des chaînes dans le script serveur

    Utilisez le script serveur pour traduire les options de schéma et d’autres valeurs pendant l’exécution côté serveur.

    Script serveur
    function() {  
      data.message=gs.getMessage("this message contains 'quotes'");
      //You can also translate schema options using the server script
      //For example, data.message=gs.getMessage(options.title);
    }
    Modèle HTML
    <div>  
      <p>{{c.data.message}}</p>
    </div>