Apache Adobe Flex TutorialTutoriaux Adobe Flex & AIR en Français

Flex Localization – Utilisation des Resource Bundles avec @Resource

Après avoir crée des fichiers ressources (fichiers .properties), vous pouvez les utiliser dans votre application Flex en tant que Resource Bundle (le compilateur convertit les fichiers .properties en sous-classe de la classe ResourceBundle quand vous compiler votre appli). Vous pouvez soit faire un "bind" (liaison) depuis une ressource vers une expression, ou vous pouvez utiliser les méthode de la classe ResourceBundle pour accéder à ces valeurs.

Il y a deux méthodes pour accéder aux valeurs d'un Resource Bundle :

• L'instruction @Resource
• Les méthodes de la classe ResourceManager

L'utilisation de la directive @Resource reste la méthode la plus simple pour inclure des Resource Bundles dans votre application. Dans cette instruction, vous spécifiez le nom du fichier .properties et la clé que vous voulez utiliser (rappelez-vous, les fichiers .properties sont sous la forme clé=valeur).  Cette méthode est simple, mais aussi restrictive par son utilisation. Par exemple, vous ne pouvez utiliser la directive @Resource qu'en MXML, et vous ne pourrez pas changer la langue à l'exécution. De plus, cette méthode ne retourne que des String.

L'autre méthode est d'accéder aux Resource Bundles par la classe ResourceManager. Vous pouvez utiliser les méthodes de la classe ResourceManager en ActionScript alors que vous ne pouvez utiliser la directive @Resource qu'en MXML. Ces méthodes peuvent renvoyer d'autres types de données que des String, comme par exemple des int, Boolean ou Number. Vous pouvez aussi utiliser cette classe pour changer de langue at runtime.

Utilisation de la directive @Resource

Dans du MXML, vous pouvez utiliser la directive @Resource pour accéder aux RB. Il faut passer à cette directive le nom Bundle (le nom du fichier .properties sans l'extension) ainsi que le nom de la clé à retrouver dans le fichier properties. Cette directive renvoie une String correspondant à la valeur de la clé du RB.

L'exemple suivante crée un formulaire. Les valeurs de labels du formulaire sont extraites du fichier ressource RegistrationForm.properties:

<?xml version="1.0"?>
<mx:Application xmlns:mx="http://www.adobe.com/2006/mxml">
    <mx:Form>
        <mx:FormItem label="@Resource(key='personname', bundle='RegistrationForm')">
            <mx:TextInput/>
        </mx:FormItem>
        <mx:FormItem label="@Resource(key='street_address', bundle='RegistrationForm')">
            <mx:TextInput/>
        </mx:FormItem>
        <mx:FormItem label="@Resource(key='city', bundle='RegistrationForm')">
            <mx:TextInput/>
        </mx:FormItem>
        <mx:FormItem label="@Resource(key='state', bundle='RegistrationForm')">
            <mx:TextInput/>
        </mx:FormItem>
        <mx:FormItem label="@Resource(key='zip', bundle='RegistrationForm')">
            <mx:TextInput/>
        </mx:FormItem>
    </mx:Form>
</mx:Application>

Flex Source Code Download: Télécharger le code source complet de l'application

Pour rappel, le fichier RegistrationForm.properties est le suivant:

registration_title=Registration
submit_button=Submit Form
personname=Name
street_address=Street Address
city=City
state=State
zip=ZIP Code
thanks=Thank you for registering!

Et les options du compilateur sont les suivantes:

-locale=en_US -allow-source-path-overlap=true -source-path=locale/{locale}

Pour en savoir plus sur comment compiler cet exemple Flex:

Flex Localization - Compilation de ressources dans une application Flex 

Si vous voulez récupérer une classe en non une String, vous devez utiliser la directive ClassReference() dans votre fichier properties. L'exemple suivante embarque la classe MyCheckBoxIcon_en_US dans le fichier properties:

CHECKBOXSKIN=ClassReference("MyCheckBoxIcon_en_US")

Vous pouvez ensuite référencer cette classe dans une propriété de type style comme ceci:

<mx:CheckBox selected="true"
    selectedUpIcon="@Resource(key='bundle1', 'CHECKBOXSKIN')"
    selectedDownIcon="@Resource(key='bundle1', 'CHECKBOXSKIN')"
    selectedOverIcon="@Resource(key='bundle1', 'CHECKBOXSKIN')"
/>

Pour utiliser des éléments binaires comme des images, vous devez embarquer l'image dans le fichier properties. Vous pourrez ensuite utiliser cet élément comme n'importe quelle image. Pour embarquer une image dans un fichier properties, utilisez la directive Embed() comme dans cet exemple:

flag=Embed("images/unitedstates.gif")

L'emplacement de l'image est relatif à celui du fichier properties. Dans le cas de l'exemple ci-dessus, le répertoire de l'image est dans locale/en_US/.
Dans votre application, utilisez la directive @Resource n'importe où l'on attend une String indiquant le chemin de l'image. Par exemple dans un <mx:Image>:

<mx:Image source="@Resource(key='flag', bundle='RegistrationForm')"/>