Localisation Web UI Framework-Localisation côté client

La localisation côté client implique la localisation des libellés d'interface utilisateur et d'autres textes et images non-champ de l'interface utilisateur. La localisation côté serveur implique la localisation du texte de zone et des images référencées par le côté client.

A propos de cette tâche

Pour plus d'informations, reportez-vous à la documentation de l'API Java™ dans votre répertoire d'installation.

Procédure

  1. Pour localiser des images, configurez un fichier CSS spécifique à l'environnement local qui sera utilisé par une bibliothèque de balises.
  2. Pour localiser du texte, configurez un fichier bundle JavaScript global. Ce fichier bundle inclut des paires de valeurs de clé (la chaîne à localiser et la valeur localisée de cette chaîne). Web UI Framework fournit une bibliothèque de balises qui inclut le fichier de bundle global.
    Exemple de fichier de bundle global:
    Remarque: IBM® recommande de préfixer les clés de fichier de bundle avec "b_" afin d'éviter les conflits avec d'autres propriétés à l'écran.
    Ext.override(sc.plat.ui.Screen, {
        'b_key1': 'value one',
        'b_key2': 'value two',
        'b_key3': 'value three'    
    })
    

    Chaque formulaire de l'application possède un fichier bundle.js spécifique qui doit être inclus avec le fichier d'écran. Par exemple, si le fichier de bundle au format login.js est sc.ui.login.bundle.js, lors de l'accès à un écran, la bibliothèque de balises recherche ce fichier de bundle et ce formulaire et les inclut à l'écran. La bibliothèque de balises n'inclut pas automatiquement le fichier de bundle pour un écran. Pour un fichier localisable (tel qu'un fichier bundle) inclus à l'aide de la commande scuitag, la balise inclut automatiquement le fichier localisé (fr, de, jp, etc.), en fonction de l'environnement local de l'utilisateur.

    Lorsqu'un fichier individuel utilisant des définitions JSB est inclus, l'entrée du fichier bundle doit être effectuée après l'entrée pour inclure le fichier écran. Les fichiers écran doivent être inclus dans l'ordre suivant:
    1. <écran>_config.js
    2. <écran> .js
    3. <écran>_bundle.js
    Exemple d'écran référençant un fichier de bundle:
    com.xyz.MyScreen = Ext.extend(sc.plat.ui.ExtensibleScreen, 
    {
            className: "sc.plat.ui.Screen",
            getUIConfig: function() {
                    return {
                            title: this.b_key1,
    			                     items:[{
    				                            xtype: 'label',
                                    text: this.b_key2
    			                     }]
                     }
    	       },
            getInfoMessage: function() {
    		              return this.b_key3;
            }
    });
    

    L'exemple suivant montre comment un formulaire est configuré pour renvoyer un nom de fichier de liasse lorsque la méthode getBundleFor(form name) de la classe SCUILocalizationProvider est appelée par l'écran. Le mot clé this renvoie l'instance de la forme, de sorte que this.First_Name renvoie le fichier de regroupement Prénom.

    First_Name = "First Name";
    Last_Name = "Last Name";
    Search_View = "Search View";
    Ext.onReady(function(){ 
    var form = new Ext.FormPanel({
            name: 'view', 
            title: this.Search_View,
            xtype: 'form',
            items: [{
                          fieldLabel: this.First_Name,
                          xtype: 'textfield',
                          appValidator: validatorApplication,
                          validationEvent: 'blur',
                          validator: validateString
                     },
                     {
                          fieldLabel: this.Last_Name,
                          xtype: 'textfield',
                      }]
             });
             form.render(Ext.getBody());
    });