Texte multilingue et code ActionScript



Grâce à ActionScript®, vous pouvez contrôler du texte multilingue et importer des fichiers multilingues XML.

    Utilisation d'ActionScript pour charger des fichiers externes

    Pour charger des données XML existantes ou utiliser un format différent pour le fichier XML, vous pouvez utiliser l'action loadVariables, l'action getURL, l'objet LoadVars ou l'objet XML pour créer un document qui contienne du texte multilingue en plaçant le texte dans un texte externe ou un fichier XML et en chargeant le fichier dans le clip à l'exécution.

    Vous devez enregistrer le fichier externe au format UTF-8 (recommandé), UTF-16BE ou UTF-16LE en utilisant une application prenant le format en charge. Si vous utilisez le format UTF-16BE ou UTF-16LE, le fichier doit commencer par une marque d'ordre d'octet (BOM) pour identifier le format d'encodage vers Flash Player. Le tableau suivant contient la marque à inclure pour identifier l'encodage :
    Remarque : la plupart des éditeurs de texte permettant d'enregistrer des fichiers au format UTF-16BE ou LE ajoutent automatiquement les marques dans les fichiers.

    Format UTF

    Premier octet

    Deuxième octet

    UTF-16BE

    OxFE

    OxFF

    UTF-16LE

    OxFF

    OxFE
    Remarque : si le fichier externe est un fichier XML, vous ne pouvez pas utiliser de balise d'encodage XML pour modifier l'encodage du fichier. Vous devez enregistrer le fichier sous un format Unicode pris en charge.
    1. Dans l'outil de programmation Flash, créez un champ de texte dynamique ou de saisie pour afficher le texte dans le document.
    2. Dans l'inspecteur des propriétés, avec le champ de texte sélectionné, attribuez un nom d'occurrence au champ de texte.
    3. Hors de Flash, créez un fichier texte ou XML définissant la valeur de la variable du champ de texte.
    4. Enregistrez le fichier XML sous le format UTF-8 (recommandé), UTF-16BE ou UTF-16LE.
    5. Utilisez l'une des procédures ActionScript suivantes pour référencer le fichier externe et le charger dans le champ de texte dynamique ou de saisie :

      • Utilisez la commande loadVariables pour charger un fichier externe.

      • Utilisez la commande getURL pour charger un fichier externe à partir d'une URL spécifiée.

      • Utilisez l'objet LoadVars (objet client/serveur prédéfini) pour charger un fichier texte externe à partir d'une URL spécifiée.

      • Utilisez l'objet XML (objet client/serveur prédéfini) pour charger un fichier XML externe à partir d'une URL spécifiée. Pour plus d'informations, consultez la section XML dans le Guide de référence du langage ActionScript 2.0.

    Création de texte multilingue à l'aide de l'action #include

    Création d'un document avec du texte multilingue à l'aide de #include.

    Vous devez utiliser une application prenant en charge le codage UTF-8, comme Dreamweaver, pour enregistrer le fichier texte au format UTF-8.

    Vous devez insérer l'en-tête suivant comme première ligne du fichier pour identifier le fichier comme étant au format Unicode pour l'outil de programmation Flash :

    //!-- UTF8
    Remarque : veillez à insérer un espace après le second tiret (-).

    Par défaut, l'application de programmation Flash suppose que les fichiers externes utilisant la commande #include sont codés selon la page de code classique du système d'exploitation exécutant l'outil de programmation. L'utilisation de l'en-tête //!-- UTF8 dans un fichier informe l'outil de programmation que le fichier externe est codé en UTF-8.

    1. Dans l'outil de programmation Flash, créez un champ de texte dynamique ou de saisie pour afficher le texte dans le document.
    2. Dans l'inspecteur des propriétés, avec le champ de texte sélectionné, attribuez un nom d'occurrence au champ de texte.
    3. Hors de Flash, créez un fichier texte ou XML définissant la valeur de la variable du champ de texte. Ajoutez l'en-tête //! au début du fichier.
    4. Enregistrez le fichier texte au format UTF-8.
    5. Pour inclure le fichier externe dans le champ de texte dynamique ou de saisie, utilisez la directive #include. Pour plus d'informations, consultez la directive #include dans le Guide de référence du langage ActionScript 2.0.

    Création de documents multilingues à l'aide de variables texte

    Vous pouvez insérer du contenu codé en Unicode dans les variables de texte à l'aide de la syntaxe \uXXXX où \uXXXX est le code hexadécimal sur quatre chiffres, ou caractère d'échappement, du caractère Unicode. L'outil de programmation Flash prend en charge les caractères d'échappement Unicode jusqu'à \uFFFF. Pour trouver les points de code des caractères Unicode, consultez la norme Unicode à l'adresse Unicode.org.

    Vous ne pouvez utiliser des caractères d'espace Unicode que dans des variables de champs de texte. Vous ne pouvez pas insérer de caractères d'espace Unicode dans des fichiers texte ou XML externes ; Flash Player 6 ne reconnaît pas les caractères d'espace Unicode des fichiers externes.

    Par exemple, pour définir un champ de texte dynamique (avec le nom d'occurrence myTextVar) contenant des caractères japonais, coréen, chinois, anglais, hébreu et grec et le symbole Euro, vous pouvez saisir comme suit :

    myTextVar.text = "\u304B\uD55C\u6C49hello\u03BB\u20AC";

    Lorsque le fichier SWF est lu, les caractères suivants s'affichent dans le champ de texte :

    Exemple qui montre les caractères obtenus dans le champ de texte.

    Pour obtenir de meilleurs résultats lors de la création d'un champ de texte contenant plusieurs langues, veillez à utiliser une police comprenant tous les glyphes nécessaires pour votre texte.

    Utilisation du composant XMLConnector pour se connecter à des fichiers XML externes

    Vous pouvez utiliser le composant XMLConnector pour vous connecter à un document XML externe afin de relier des propriétés dans le document. Il vise à lire ou à écrire des documents XML à l'aide d'opérations GET, opérations POST ou les deux. Il agit comme un connecteur entre d'autres composants et des documents XML externes. Le composant XMLConnector communique avec des composants de votre application en utilisant soit des fonctions de liaison de données de l'environnement de programmation Flash Professionel, soit du code ActionScript. Pour plus d'informations, consultez le composant XML Connector dans le Guide de référence des composants du langage ActionScript 2.0.