Présentation du package flash.globalization

Flash Player 10.1 et les versions ultérieures, Adobe AIR 2.0 et les versions ultérieures

Le package flash.globalization exploite les fonctionnalités de prise en charge culturelle du système d’exploitation sous-jacent. Il simplifie la programmation d’applications conformes aux conventions culturelles de chaque utilisateur.

Parmi les principales classes du package figurent :

  • La classe Collator, qui gère le tri et la concordance des chaînes.

  • La classe CurrencyFormatter, qui formate les nombres convertis en chaînes de montant de devise et analyse les symboles et montants de devise extraits de chaînes d’entrée.

  • La classe DateTimeFormatter, qui formate les valeurs de date.

  • La classe LocaleID, qui extrait les informations relatives à des paramètres régionaux donnés.

  • La classe NumberFormatter, qui formate et analyse les valeurs numériques.

  • La classe StringTools, qui gère la conversion de la casse des chaînes gérées par les paramètres régionaux.

Package flash.globalization et localisation des ressources

Le package flash.globalization ne gère pas la localisation des ressources. Vous pouvez toutefois utiliser l’ID de paramètres régionaux flash.globalization en tant que principale valeur d’extraction des ressources localisées par le biais d’autres techniques. Il est ainsi possible de localiser les ressources d’une application créées dans Flex à l’aide des classes ResourceManager et ResourceBundle. Pour plus d’informations, voir Localisation d’applications Flex .

Adobe AIR 1.1 contient également quelques fonctions destinées à faciliter la localisation des applications AIR, comme indiqué à la section Localisation d’applications AIR .

Guide général de l’internationalisation d’une application

La procédure ci-dessous décrit une approche standard de haut niveau de l’internationalisation d’une application à l’aide du package flash.globalization :

  1. Déterminez ou définissez les paramètres régionaux.

  2. Créez une occurrence d’une classe de service (Collator, CurrencyFormatter, DateTimeFormatter, NumberFormatter ou StringTools).

  3. Recherchez les erreurs et les paramètres de substitution par le biais des propriétés lastOperationStatus.

  4. Formatez et affichez les informations à l’aide des paramètres régionaux en vigueur.

L’étape suivante consiste à charger et afficher les chaînes et ressources de l’interface utilisateur propres aux paramètres régionaux. Cette étape est susceptible d’inclure des tâches telles que :

  • redimensionner l’interface utilisateur en fonction des longueurs de chaîne par le biais des fonctions de mise en forme automatique ;

  • sélectionner les polices appropriées et les polices de substitution prises en charge ;

  • prendre en charge d’autres systèmes d’écriture à l’aide de FTE (Flash Text Engine) ;

  • vérifier la gestion appropriée des éditeurs de méthode d’entrée.

Recherche des erreurs et paramètres de substitution

Les classes de service flash.globalization adoptent toutes une approche similaire pour identifier les erreurs. En cas de non-disponibilité des paramètres régionaux requis, elles ont également toutes recours aux paramètres régionaux pris en charge par le système d’exploitation de l’utilisateur.

L’exemple suivant indique comment rechercher les erreurs et paramètres de substitution lors de l’instanciation de classes de service. Chaque classe de service possède une propriété lastOperationStatus, qui indique si la dernière méthode utilisée a déclenché des messages d’erreur ou des avertissements. 

var nf:NumberFormatter = new NumberFormatter("de-DE"); 
if(nf.lastOperationStatus != LastOperationStatus.NO_ERROR) 
{ 
    if(nf.lastOperationStatus == LastOperationStatus.USING_FALLBACK_WARNING) 
    { 
        // perform fallback logic here, if needed 
        trace("Warning - Fallback locale ID: " + nf.actualLocaleIDName); 
    } 
    else 
    { 
        // perform error handling logic here, if needed 
        trace("Error: " + nf.lastOperationStatus); 
    } 
}

Cet exemple se contente de suivre un message si un ID de paramètres régionaux de substitution est utilisé ou s’il se produit une erreur. Le cas échéant, l’application peut mettre en œuvre d’autres opérations logiques de gestion des erreurs. Vous pouvez, par exemple, afficher un message à l’intention de l’utilisateur ou imposer à l’application d’utiliser des paramètres régionaux spécifiques et pris en charge.