Prise en main d’ActionScript

Le langage de script ActionScript® vous permet d’ajouter à votre application des interactivités complexes, des contrôles de lecture et l’affichage de données. Vous pouvez ajouter des instructions ActionScript dans l’environnement de création à l’aide du panneau Actions, de la fenêtre Script ou d’un éditeur externe.

ActionScript suit ses propres règles de syntaxe, ses mots-clés réservés et vous permet d’utiliser des variables pour stocker et recouvrer des informations. ActionScript comprend une bibliothèque volumineuse de classes intégrées qui vous permettent de créer des objets pour exécuter des tâches nombreuses très pratiques. Pour plus d’informations sur ActionScript, voir les titres suivants :

Il n’est pas nécessaire de connaître toutes les utilisations possibles de chaque élément ActionScript pour commencer à rédiger des scripts. Si vous avez un objectif précis, vous pouvez commencer par des actions simples.

ActionScript et JavaScript sont tous les deux basés sur la norme ECMA-262, norme internationale pour le langage de programmation ECMAscript. C’est pourquoi les développeurs expérimentés en JavaScript se familiarisent très rapidement avec ActionScript. Pour plus d’informations sur ECMAScript, reportez-vous au site ecma-international.org.

Adobe recommande...

Adobe recommande...

Quelle version d’ActionScript devez-vous utiliser ?

Pour satisfaire les besoins de plusieurs catégories de développeurs et les caractéristiques des matériels de lecture, Animate comprend plusieurs versions d’ActionScript. ActionScript 3.0 et 2.0 ne sont pas mutuellement compatibles.

 

  • ActionScript 3.0 s’exécute très rapidement. Cette version exige plus d’expérience en matière de programmation orientée objets que les autres versions d’ActionScript. La version ActionScript 3.0 est entièrement compatible avec les spécifications ECMAScript. Cette version offre un meilleur traitement du langage XML, un modèle d’événement amélioré et une architecture perfectionnée pour utiliser les éléments à l’écran. Les fichiers FLA utilisés par ActionScript 3.0 ne peuvent pas inclure des versions antérieures d’ActionScript.

  • (Abandonné dans Animate CC uniquement) Il est plus facile d’apprendre à utiliser ActionScript 2.0 qu’ActionScript 3.0. Bien que Flash Player exécute plus lentement le code ActionScript 2.0 compilé que le code ActionScript 3.0 compilé, ActionScript 2.0 reste utile pour plusieurs types de projets. ActionScript 2.0 est aussi utile pour les projets qui ne nécessitent pas de calculs intensifs, par exemple, un contenu plus orienté sur l’aspect graphique. ActionScript 2.0 est aussi basé sur les spécifications ECMAScript, mais n’est pas entièrement compatible avec cette norme.

  • (Abandonné dans Animate CC) ActionScript 1.0 est la version la plus simple. Elle est toujours utilisée par certaines versions de Adobe Flash Lite Player. ActionScript 1.0 et 2.0 peuvent cohabiter dans le même fichier FLA.

  • (Abandonné dans Animate CC) ActionScript Flash Lite 2.x est un sous-ensemble d’ActionScript 2.0 qui est pris en charge par Flash Lite 2.x et qui s’exécute sur les appareils et téléphones mobiles.

  • (Abandonné dans Animate CC) ActionScript Flash Lite 1.x est un sous-ensemble d’ActionScript 1.0 qui est pris en charge par Flash Lite 1.x et qui s’exécute sur les appareils et téléphones mobiles.

 

Utilisation de la documentation d’ActionScript

Comme il existe plusieurs versions d’ActionScript (2.0 et 3.0), et de nombreuses façons de l’intégrer dans vos fichiers FLA, l’apprentissage de ce langage peut prendre différentes formes.

Ce chapitre décrit l’interface utilisateur graphique permettant d’utiliser ActionScript. Cette interface comprend les panneaux Actions, Comportements, Sortie et Erreurs de compilateur, la fenêtre de script et le mode Assistant de script. Ces rubriques concernent toutes les versions d’ActionScript.

D’autres documents Adobe consacrés à ActionScript vous aideront à bien comprendre les différentes versions d’ActionScript.

Méthodes de travail avec ActionScript

Il existe plusieurs manières de travailler avec ActionScript.

  • (Abandonné dans Animate CC) Le mode Assistant de script permet d’ajouter du code ActionScript à votre fichier FLA sans écrire ce code vous-même. Vous sélectionnez des actions et le logiciel vous présente une interface utilisateur pour saisir des paramètres correspondant à chacune d’entre elles. Vous devez connaître les fonctions à utiliser pour accomplir des tâches spécifiques, mais vous n’avez pas besoin d’apprendre la syntaxe. De nombreux concepteurs et non-programmeurs utilisent ce mode.

  • (Abandonné dans Animate CC) Les comportements permettent également d’ajouter du code à votre fichier sans l’écrire vous-même. Les comportements sont en réalité des scripts préécrits pour exécuter des tâches courantes. Vous pouvez ajouter un comportement, puis le configurer facilement dans le panneau Comportements. Les comportements ne sont disponibles qu’à partir de la version ActionScript 2.0.

  • L’écriture de votre propre code ActionScript vous offre plus de flexibilité et de contrôle sur votre document, mais, pour ce faire, vous devez maîtriser le langage et les conventions d’ActionScript.

  • Les composants sont des clips vidéo prédéfinis qui vous permettent de mettre en place des fonctionnalités complexes. Un composant peut être une simple commande d’interface utilisateur, tel qu’une case à cocher ou un élément de commande plus complexe, tel qu’un panneau de défilement. Vous pouvez personnaliser l’apparence et le fonctionnement d’un composant. Vous pouvez également télécharger des composants développés par d’autres programmeurs. Vous devez rédiger vous-même du code ActionScript pour la plupart des composants afin de déclencher ou contrôler un composant. Pour plus d’informations, voir Utilisation de composants ActionScript 3.0.

 

Écriture de code ActionScript

Lorsque vous écrivez du code ActionScript dans un environnement de création, vous utilisez le panneau Actions ou la fenêtre de script. Le panneau Actions et la fenêtre de script contiennent un éditeur de code très complet qui comprend conseils et coloration du code, mise en forme du code et mise en évidence de la syntaxe. Il contient également le débogage, la numérotation des lignes, le retour à la ligne automatique et la prise en charge d’Unicode.

  • Utilisez le panneau Actions pour écrire les scripts qui font partie de votre document Animate (scripts intégrés au fichier FLA). Le panneau Actions fournit des fonctionnalités telles que la boîte à outils Actions, qui permet d’accéder rapidement aux principaux éléments du langage ActionScript. Vous obtenez des instructions pour les éléments qui nécessitent la création de scripts.

  • Utilisez la fenêtre de script pour écrire des scripts externes (scripts ou classes stockés dans des fichiers externes). (Vous pouvez également utiliser un éditeur de texte pour créer un fichier AS externe.) La fenêtre Script comprend des fonctionnalités d’aide à l’écriture de code, telles que la coloration et les conseils, la vérification de la syntaxe et la mise en forme automatique.

Autre contenu de la communauté recommandé

Les articles et tutoriels suivants contiennent davantage d’informations sur l’utilisation d’ActionScript :

Présentation du panneau Sortie

Lorsque vous testez un type quelconque de document, le panneau Sortie affiche des informations ou un avertissement associé aux opérations telles que les conversions de documents et la publication. Pour afficher ces informations, ajoutez une instruction trace() à votre code ou utilisez les commandes Lister les objets et Lister les variables.

Si vous utilisez l’instruction trace() dans vos scripts, vous pouvez envoyer certaines informations au panneau Sortie pendant l’exécution du fichier SWF. Il peut s’agir de notes relatives à l’état du fichier SWF ou à la valeur d’une expression. 

Output_panel
Panneau Sortie

Le panneau Sortie propose les options suivantes :

  • Copier : copie tout le contenu du panneau Sortie dans le Presse-papiers de l’ordinateur. Pour copier uniquement la sélection, sélectionnez les données à copier, puis choisissez Copier.
  • Effacer : efface le contenu du panneau Sortie.
  • Afficher la sortie : affiche le contenu du panneau Sortie.
  • Verrouiller : verrouille le panneau. Vous pouvez redimensionner le panneau, mais vous ne pouvez pas le déplacer ni le faire glisser.
  • Aide : ouvre l’aide en ligne du panneau Sortie.
  • Fermer : ferme le panneau Sortie.
  • Fermer le groupe : ferme le groupe entier de panneaux. Vous pouvez ancrer simultanément plusieurs panneaux tels que le scénario, le panneau Sortie et le panneau Erreurs de compilation.

Pour afficher ou masquer le panneau Sortie, sélectionnez Fenêtre > Sortie ou appuyez sur la touche F2.

Panneau Actions

Vous recherchez un guide de référence de langage ?

Pour trouver le guide de référence d’un élément de langage ActionScript spécifique, procédez de l’une des façons suivantes :

Remarque :

pour ouvrir l’Aide dans une fenêtre de navigateur plutôt que dans l’application d’Aide de la communauté, consultez l’article suivant : http://kb2.adobe.com/community/publishing/916/cpsid_91609.html.

Formation à ActionScript 

Pour plus de détails sur l’écriture du code ActionScript, consultez les ressources suivantes :

Remarque :

ActionScript 3.0 et 2.0 ne sont pas mutuellement compatibles. Sélectionnez une seule version pour chaque fichier FLA créé.

Présentation du panneau Actions

Pour créer des scripts intégrés dans un fichier FLA, saisissez ActionScript directement dans le panneau Actions (Fenêtre > Actions ou appuyez sur F9).

actions-frame-view
Panneau Actions

Le panneau Actions comporte deux volets :

Fenêtre de script

Permet d’écrire du code ActionScript, qui est associé à l’image actuellement sélectionnée.

Navigateur de script

Ce navigateur répertorie les scripts de votre document Animate et permet d’y accéder rapidement. Cliquez sur un élément dans ce navigateur pour afficher le script dans le volet Script.

Le panneau Actions permet d’accéder aux fonctionnalités d’aide à la programmation qui simplifient et rationalisent l’écriture du code dans ActionScript. Vous pouvez ajouter des scripts globaux et tiers spécifiques non graphiques qui peuvent être appliqués à toute l’animation depuis Animate. Pour en savoir plus, voir la section Ajout de scripts globaux et tiers sur cette page. 

  • Exécuter le script : exécute le script.
  • Verrouiller le script : épingle le script aux onglets verrouillés de scripts individuels dans le volet Script et les déplace en conséquence. Cette fonction est utile si vous n’avez pas centralisé le code du fichier FLA ou si vous utilisez plusieurs scripts. Vous pouvez épingler un script pour conserver l’emplacement du code ouvert dans le panneau Actions et permuter entre les divers scripts ouverts. Cette fonction s’avère particulièrement pratique lors de la phase de débogage.
  • Insérer le chemin ou le nom de l’occurrence : permet de définir un chemin cible absolu ou relatif pour une action du script.
  • Rechercher : recherche et remplace du texte dans votre script.
  • Formater le code : permet de formater le code.
  • Fragments de code : ouvre le panneau Fragments de code, qui affiche des exemples de fragments de code.
  • Ajouter à l’aide de l’assistant : ajoute des actions à l’aide d’un assistant convivial sans que vous ayez à écrire du code.
  • Aide : affiche des informations de référence concernant l’élément ActionScript qui est sélectionné dans la fenêtre Script. Par exemple, si vous cliquez sur une instruction import, puis sur Aide, la rubrique d’aide relative à import s’affiche dans le panneau Aide.

Utilisation de l’assistant de code d’actions

Vous pouvez ajouter de l’interactivité aux compositions HTML5 grâce à l’option Ajouter à l’aide de l’assistant du panneau Actions. Cette fonctionnalité propose une interface utilisateur simplifiée pour ajouter du code à vos compositions.

Une vidéo décrivant comment ajouter du code à l’aide de l’assistant de code d’actions

  1. Créez un document HTML5 Canvas et cliquez sur Fenêtre > Actions.

  2. Cliquez sur l’onglet Ajouter à l’aide de l’assistant dans le panneau Actions, comme indiqué sur la capture d’écran suivante.

    addusingwizard-button
    Panneau Actions avec le bouton Ajouter à l’aide de l’assistant
  3. Sélectionnez une action pour laquelle vous souhaitez créer du code à l’aide de l’assistant de code.

    Exemple de capture d’écran affichant les options de l’assistant de code d’actions pour les actions

    Sur la capture d’écran ci-dessus, vous voyez que l’action Obtenir le numéro d’image est sélectionnée et que le code correspondant a été mis à jour dans la fenêtre d’action.

    En fonction du type d’action que vous sélectionnez, vous pouvez également choisir l’objet auquel il faut appliquer l’action. Vous pouvez rechercher des objets spécifiques sur la scène si l’objet a un nom d’instance. De plus, vous pouvez appliquer l’action à la sélection actuelle. 

    actions-code-currentselection
    Liste des objets sur lesquels l’action doit être appliquée
  4. Cliquez sur Suivant pour choisir un événement déclencheur. Un ensemble d’événements déclencheurs est présenté dans la fenêtre en fonction du type d’action et du type d’objet que vous avez sélectionnés lors des étapes précédentes.

    action-trigger
    Liste des événements déclencheurs
  5. Sélectionnez un événement déclencheur approprié, suivi des éventuels objets déclencheurs correspondants, puis cliquez sur le bouton Terminer et ajouter.

Vous pouvez choisir l’option Sélection actuelle du menu lorsque vous sélectionnez un objet sur la scène et exécutez l’assistant de code d’actions. Vous pouvez également choisir le scénario et les actions de composants pour le code.

Utilisation de la fenêtre de script

La fenêtre de script vous permet de créer des fichiers de script externes que vous importerez dans votre application. Ces scripts peuvent être des fichiers JavaScript Animate ou ActionScript.

Vous pouvez également ajouter des scripts globaux et tiers dans les documents HTML5 Canvas. Pour en savoir plus, voir la section Ajout de scripts globaux et tiers dans le chapitre Création et publication de documents HTML5 Canvas dans Animate CC

actions-add-script
Fenêtre Script

Si plusieurs de vos fichiers externes sont ouverts, leurs noms apparaissent sur les onglets en haut de la fenêtre de script.

Vous pouvez utiliser les fonctions suivantes dans la fenêtre de script : épingler le script, rechercher et remplacer, coloration de la syntaxe, formatage du code, conseils de code, commentaires de code, réduction de code, options de débogage (fichiers ActionScript uniquement) et retour à la ligne. La fenêtre de script permet également d’afficher les numéros de ligne et les caractères masqués.

Création d’un fichier externe dans la fenêtre de script

  1. Sélectionnez Fichier > Nouveau.

    Nouveau document
    Nouveau document
  2. Choisissez un mode dans les onglets situés en haut de l’écran, tels que Animation des personnages, Social, Jeu, Éducation, Publicités, Web et Avancé. Sélectionnez le type de fichier externe à créer (fichier ActionScript ou Flash JavaScript).

Modification d’un fichier existant dans la fenêtre de script

  • Pour ouvrir un script existant, choisissez Fichier > Ouvrir, puis ouvrez un fichier ActionScript (AS) existant.

  • Pour modifier un script déjà ouvert, cliquez sur l’onglet du document portant le nom du script.

Outils du panneau Actions et de la fenêtre de script

Le panneau Actions permet d’accéder aux fonctionnalités d’aide à la programmation qui simplifient et rationalisent l’écriture du code dans ActionScript.

Rechercher 

Recherche et remplace du texte dans le script.

 

Insérer un chemin cible 

(Panneau Actions uniquement) Vous aide à définir un chemin cible absolu ou relatif pour une action du script.

 

Aide 

Affiche des informations de référence concernant l’élément ActionScript qui est sélectionné dans la fenêtre Script. Par exemple, si vous cliquez sur une instruction import, puis sur Aide, la rubrique d’aide relative à import s’affiche dans le panneau Aide.

 

Fragments de code

Ouvre le panneau Fragments de code, qui affiche des exemples de fragments de code.

 

Ajout à l’aide de l’assistant

Vous permet d’ajouter du code pour des actions à l’aide d’une interface sans avoir à écrire du code. 

Accès à l’aide contextuelle dans le panneau Actions

  1. Pour sélectionner un élément de référence, effectuez l’une des opérations suivantes :
    • Sélectionnez un terme ActionScript dans la fenêtre de la boîte à outils du panneau Actions (partie gauche du panneau Actions).

    • Sélectionnez un élément ActionScript dans la fenêtre Script du panneau Actions.

    • Placez le point d’insertion avant un terme ActionScript dans la fenêtre Script du panneau Actions.

  2. Pour ouvrir la page de référence de l’élément sélectionné dans le panneau Aide, effectuez l’une des opérations suivantes :
    • Appuyez sur la touche F1.

    • Cliquez avec le bouton droit de la souris sur l’élément et sélectionnez Afficher l’aide.

    • Cliquez sur Aide au-dessus de la fenêtre Script.

Définition de vos préférences ActionScript

Que vous travailliez dans le panneau Actions ou dans la fenêtre de script, vous ne pouvez définir et modifier qu’un seul jeu de préférences.

  1. Sélectionnez Modifier > Préférences (Windows) ou Animate > Préférences (Macintosh), puis cliquez sur Éditeur de code dans la liste des catégories.

  2. Définissez n’importe laquelle des préférences suivantes :

    Indentation automatique

    Lorsque l’indentation automatique est activée, le texte saisi après une parenthèse ouvrante « ( » est automatiquement mis en retrait conformément à la valeur de taille des tabulations définie. Ce comportement s’applique également lorsque vous utilisez une accolade ouvrante « { ».

    Taille des tabulations

    Spécifie le nombre de caractères de chaque ligne avant sa mise en retrait.

    Conseils de code

    Active l’affichage des conseils de code dans la fenêtre de script.

    Délai

    Précise le délai (en secondes) devant s’écouler avant l’affichage des conseils de code. Cette option n’est plus disponible dans Animate CC.

    Police

    Spécifie la police à utiliser pour votre script.

    Ouvrir/Importer

    Spécifie le codage des caractères utilisé pour l’ouverture et l’importation de fichiers ActionScript.

    Enregistrer/Exporter

    Spécifie le codage des caractères utilisé pour l’enregistrement et l’exportation de fichiers ActionScript.

    Recharger les fichiers modifiés

    Spécifie ce qui se produit lors de la modification, le déplacement et la suppression d’un fichier de script. Sélectionnez Toujours, Jamais ou Invite.

    Toujours

    Aucun avertissement n’est affiché et le fichier est rechargé automatiquement.

    Jamais

    Aucun avertissement n’est affiché et le fichier conserve son état actuel.

    Invite

    (par défaut) Un avertissement est affiché et vous pouvez décider si le fichier est à recharger ou non.

    Lorsque vous élaborez des applications faisant appel à des scripts externes, cette préférence évite d’écraser un script ou de publier l’application avec des versions de script antérieures. L’avertissement vous permet de fermer automatiquement un script pour rouvrir sa version la plus récente, modifiée.

    Couleurs de la syntaxe

    Spécifie la couleur à appliquer au code dans vos scripts.

    Paramètres d’ActionScript 3.0

    Ces boutons permettent d’ouvrir les boîtes de dialogue Paramètres d’ActionScript, dans lesquelles vous pouvez définir un chemin source, un chemin de bibliothèque ou un chemin de bibliothèque externe pour ActionScript 3.0.

Ce produit est distribué sous licence Creative Commons Attribution - Pas d’utilisation commerciale - Partage à l’identique 3.0 non transposé  Les publications Twitter™ et Facebook ne sont pas couvertes par les dispositions Creative Commons.

Mentions légales   |   Politique de confidentialité en ligne