Guide d'utilisation Annuler

Création de composants personnalisés : exemples

  1. Guide d’utilisation d’Adobe Animate
  2. Présentation d’Animate
    1. Nouveautés d’Adobe Animate
    2. Glossaire visuel
    3. Configuration requise pour Animate
    4. Raccourcis clavier d’Animate
    5. Utiliser plusieurs types de fichiers dans Animate
  3. Animation
    1. Principes de base de l’animation dans Animate
    2. Utilisation des images et des images-clés dans Animate
    3. Animation image par image dans Animate
    4. Utiliser une animation interpolée classique dans Animate
    5. Outil Pinceau
    6. Guide du mouvement
    7. Interpolation de mouvement et ActionScript 3.0
    8. À propos de l’animation d’une interpolation interpolée de mouvement
    9. Animation d’une interpolation de mouvement
    10. Création d’une animation d’interpolation de mouvement
    11. Utilisation des images-clés de propriété
    12. Animation d’une position à l’aide d’une interpolation
    13. Modification des interpolations de mouvement avec l’Éditeur de mouvement
    14. Modification de la trajectoire de mouvement d’une animation d’interpolation
    15. Manipulation d’interpolations de mouvement
    16. Ajout d’accélérations personnalisées
    17. Création et application de présélections de mouvement
    18. Configuration de plages d’interpolation d’une animation
    19. Utilisation d’interpolations de mouvement enregistrées au format XML
    20. Interpolations de mouvement et interpolations classiques : comparatif
    21. Interpolation de forme
    22. Utilisation de l’animation de l’outil de segment dans Animate
    23. Utiliser un squelettage de personnage dans Animate
    24. Utilisation de calques de masque dans Adobe Animate
    25. Utilisation de séquences dans Animate
  4. Interactivité
    1. Création de boutons avec Animate
    2. Conversion de projets Animate en d’autres formats de document
    3. Création et publication de documents HTML5 Canvas dans Animate
    4. Ajout d’interactivité à l’aide de fragments de code dans Animate
    5. Création de composants HTML5 personnalisés
    6. Utilisation de composants dans HTML5 Canvas
    7. Création de composants personnalisés : exemples
    8. Fragments de code des composants personnalisés
    9. Pratiques recommandées – Publicité avec Animate
    10. Création et publication de contenu de réalité virtuelle
  5. Espace de travail et workflow
    1. Création et gestion des pinceaux
    2. Utilisation de polices Google Fonts dans les documents HTML5 Canvas
    3. Utilisation des bibliothèques Creative Cloud et d’Adobe Animate
    4. Utilisation de la scène et du panneau Outils pour Animate
    5. Workflow et espace de travail Animate
    6. Utilisation de polices web dans les documents HTML5 Canvas
    7. Scénarios et ActionScript
    8. Utilisation de plusieurs scénarios
    9. Définition des préférences
    10. Utilisation des panneaux de création Animate
    11. Création de calques de scénario avec Animate
    12. Exportation d’animations pour les applications mobiles et les moteurs de jeu
    13. Déplacement et copie d’objets
    14. Modèles
    15. Recherche et remplacement de contenu dans Animate
    16. Commandes Annuler et Rétablir, et panneau Historique
    17. Raccourcis clavier
    18. Utilisation du scénario dans Animate
    19. Création d’extensions HTML
    20. Options d’optimisation des images et des GIF animés
    21. Paramètres d’exportation des images et des fichiers GIF
    22. Panneau Éléments dans Animate
  6. Multimédia et vidéo
    1. Transformation et combinaison d’objets graphiques dans Animate
    2. Création et utilisation d’instances de symboles dans Animate
    3. Vectorisation de l’image
    4. Utilisation du son dans Adobe Animate
    5. Exportation de fichiers SVG
    6. Création de fichiers vidéo en vue de les utiliser dans Animate
    7. Comment ajouter une vidéo dans Animate
    8. Dessin et création d’objets avec Animate
    9. Remodelage des lignes et des formes
    10. Traits, remplissages et dégradés avec Animate CC
    11. Utilisation d’Adobe Premiere Pro et d’After Effects
    12. Panneaux Couleur dans Animate CC
    13. Ouverture de fichiers Flash CS6 à l’aide d’Animate
    14. Utilisation de texte classique dans Animate
    15. Placement d’illustrations dans Animate
    16. Images bitmap importées dans Animate
    17. Graphiques 3D
    18. Utilisation de symboles dans Animate
    19. Dessin de traits et de formes avec Adobe Animate
    20. Utilisation de bibliothèques dans Animate
    21. Exportation de sons
    22. Sélection d’objets dans Animate CC
    23. Utilisation de fichiers AI d’Illustrator dans Animate
    24. Application de modes de fusion
    25. Disposition d’objets
    26. Automatisation des tâches à l’aide du menu Commandes
    27. Texte multilingue
    28. Utilisation de la caméra dans Animate
    29. Filtres graphiques
    30. Sons et ActionScript
    31. Préférences de dessin
    32. Dessin avec l’outil Plume
  7. Plateformes
    1. Conversion de projets Animate en d’autres formats de document
    2. Prise en charge des plateformes personnalisées
    3. Création et publication de documents HTML5 Canvas dans Animate
    4. Création et publication d’un document WebGL
    5. Assemblage d’applications AIR pour iOS
    6. Publication d’applications AIR pour Android
    7. Publication pour Adobe AIR for Desktop
    8. Paramètres de publication d’ActionScript
    9. Pratiques recommandées – Organisation du code ActionScript dans une application
    10. Utilisation d’ActionScript avec Animate
    11. Accessibilité dans l’espace de travail Animate
    12. Écriture et gestion des scripts
    13. Activation de la prise en charge des plateformes personnalisées
    14. Présentation de la prise en charge des plateformes personnalisées
    15. Utilisation du plug-in de prise en charge des plateformes personnalisées
    16. Débogage du code ActionScript 3.0
    17. Activation de la prise en charge des plateformes personnalisées
  8. Exportation et publication
    1. Exportation de fichiers d’Animate CC
    2. Publication OAM
    3. Exportation de fichiers SVG
    4. Exportation d’images et de vidéos avec Animate
    5. Publication de documents AS3
    6. Exportation d’animations pour les applications mobiles et les moteurs de jeu
    7. Exportation de sons
    8. Pratiques recommandées – Conseils pour la création de contenu pour appareils mobiles
    9. Pratiques recommandées – Conventions des vidéos
    10. Pratiques recommandées – Recommandations sur la création d’applications SWF
    11. Pratiques recommandées – Structuration des fichiers FLA
    12. Pratiques recommandées d’optimisation des fichiers FLA pour Animate
    13. Paramètres de publication d’ActionScript
    14. Spécification des paramètres de publication pour Animate
    15. Exportation de fichiers de projection
    16. Exportation d’images et de GIF animés
    17. Modèles de publication HTML
    18. Utilisation d’Adobe Premiere Pro et d’After Effects
    19. Partage et publication rapides de vos animations
  9. Résolution des problèmes
    1. Problèmes résolus
    2. Problèmes connus

Vous trouverez dans cet article un exemple de composant HTML5 personnalisé.

Cet article vous explique comment créer des composants personnalisés. Le premier exemple décrit le composant d’image (qui est également fourni avec Animate), ainsi que le processus permettant de comprendre la structure et les étapes faisant partie du développement. Le deuxième exemple explique comment inclure un composant d’interface utilisateur existant dans une enveloppe (comme jQueryUI) et l’importer dans Animate.

  1. Création d’un composant d’image DOM

    Créez une catégorie appelée « Mes composants ». 

    a. Commencez par créer un dossier nommé mescomposants sous le dossier <HTML5Components>.

    b. Téléchargez le fichier myimage.zip associé et extrayez-en le contenu dans le dossier

        mescomposants.

    Telechargement

    c. Redémarrez Animate.

Structure du répertoire dans le dossier mescomposants
Structure du répertoire dans le dossier mescomposants

Une nouvelle catégorie nommée « Mes composants » apparaît maintenant dans le dossier de composants, avec en dessous un nouveau composant appelé Mon image. Vous pouvez faire glisser et déplacer ce composant sur la scène, définir la propriété de l’image source et publier le film afin de visualiser le composant personnalisé en action. 

Métadonnées du composant – components.js

Code components.js
components.js

Notez que la catégorie est définie sur CATEGORY_MY_COMPONENTS. Les noms de chaque propriété utilisent également des clés similaires. Il s’agit de la clé de la chaîne localisée pour le nom de la catégorie. Si vous ouvrez le fichier strings.json depuis le dossier de paramètres régionaux, les entrées suivantes sont visibles.

 Lors de la modification de ce fichier, il n’est pas rare que les utilisateurs ajoutent par erreur une virgule superflue après le dernier élément du tableau.

Détails de la catégorie
Détails de la catégorie

La valeur du champ d’icône est définie sur Sp_Image_Sm. Le dossier Assets contient les deux fichiers png suivants, avec le préfixe Sp_Image_Sm.

Valeur du champ d’icône
Valeur du champ d’icône

Il s’agit des icônes des interfaces utilisateur sombre et claire.

La valeur du champ « source » dans le fichier components.json est définie sur « src/myimage.js ». 

(function($) {    

// Enregistre un composant avec le nom de classe : my.Image
 // et le modélise avec les remplacements suivants 
 // getCreateOptions
 // getCreateString
 // getProperties
 // getAttributes
    $.anwidget(&quot;my.Image&quot;, {
         options: {
   'visible': true,
   'position': 'absolute'
         },
  _props: [&quot;left&quot;, &quot;top&quot;, &quot;width&quot;, &quot;height&quot;, &quot;position&quot;, &quot;transform-origin&quot;, &quot;transform&quot;],
  
_attrs: [&quot;id&quot;, &quot;src&quot;, &quot;alt&quot;, &quot;class&quot;, &quot;border&quot;],
  
// Renvoie un ID unique avec l’image de préfixe
  // _widgetID est un global déclaré dans un widget
  // Cet ID est utilisé uniquement si l’utilisateur n’a défini aucun ID d’instance pour le composant dans Animate
  // Autrement, le nom configuré par l’utilisateur est utilisé
  getCreateOptions: function() {
   return $.extend(this.options, { 'id': &quot;image&quot; + _widgetID++ });
  },
  
// Renvoie la chaîne permettant de créer l’élément DOM
  // Pour l’image, il faut simplement créer la balise <img> 
  getCreateString: function() {
   return &quot;<img>&quot;;
  },
  
// Ensemble de propriétés configurables
  getProperties: function() {
   return this._props;
  },
  
// Ensemble d’attributs configurables
  getAttributes: function() {
   return this._attrs;
  }    
 });   
})(jQuery);

Reportez-vous aux commentaires dans le code afin de mieux le comprendre. 

N’hésitez pas à observer la source des autres composants fournis avec Animate. Dans la plupart des cas, vous pouvez utiliser l’un de ces composants comme point de départ, puis le configurer en fonction de vos besoins.

Inclusion dans un wrapper d’un composant jQuery-UI

Cette section explique comment inclure un widget jQuery-UI dans une enveloppe et l’utiliser dans Animate. Les mêmes concepts peuvent être appliqués pour encapsuler n’importe quel composant d’une autre infrastructure d’interface utilisateur.

Examinons le composant DatePicker compressé avec Animate  qui est un widget jQuery-UI. Téléchargez et extrayez le contenu de l’archive suivante et utilisez-le pour référence.

Telechargement

Structure du contenu extrait
Structure du contenu extrait

Le dossier nommé jquery-ui-1.12.0 est la source de l’infrastructure d’interface utilisateur jQuery qui contient le widget DatePicker d’origine et ses ressources, comme des images et des feuilles de style CSS, à encapsuler et utiliser dans Animate  comme n’importe quel autre composant HTML5. Il sert seulement pour l’aperçu local, quand vous utilisez les « bibliothèques hébergées » dans les paramètres de publication ; vous pouvez alors utiliser le réseau de diffusion de contenu afin de télécharger les sources dépendantes. 

Code components.js
components.js

Il existe deux dépendances par défaut, jQuery et anwidget.js. Puisque anwidget.js ne figure pas sur le réseau de diffusion de contenu, nous n’avons aucune entrée CDN correspondante.

Le prochain jeu d’entrées correspond aux autres ressources requises pour le chargement du widget Sélecteur de dates de l’interface utilisateur jQuery. Si vous encapsulez un widget d’une autre bibliothèque, vous pouvez également spécifier le jeu de dépendances correspondant. Ces dépendances sont téléchargées avant l’initialisation du composant.

Dans la section des propriétés, nous avons exposé une seule propriété appelée « label » (libellé), qui est liée à la propriété « label » du composant Sélecteur de dates. De même, nous pouvons exposer les autres propriétés si nous souhaitons que l’utilisateur puisse les configurer dans l’environnement de création d’Animate. Au moment de l’exécution, chacune de ces propriétés sera disponible comme paire clé-valeur dans le tableau des options pour l’occurrence. Nous pouvons extraire la valeur configurée et l’appliquer au moment de l’exécution.

Fichier source principal : src/datepicker.js.
Fichier source principal : src/datepicker.js.

Sections qui diffèrent de l’exemple

  1. getCreateString:

    Le widget Sélecteur de dates de jQuery-UI récupère cet élément d’entrée de texte et le convertit en élément de sélecteur de dates au moment de l’exécution. Nous initialisons alors l’objet DOM en conséquence.

  2. attach

    Nous devons remplacer cette fonction pour ce widget. Cette API est invoquée chaque fois que l’élément est associé à l’objet DOM. Toutefois, en raison du mode de fonctionnement de l’exécution sous-jacente (dans ce cas, createjs), cette API peut être invoquée plusieurs fois durant une plage d’images.

    Nous mémorisons l’état associé de l’élément sous-jacent puis invoquons l’API d’association (attach) de la classe de base (à l’aide de l’argument this._superApply(arguments)). Si nous associons l’élément au DOM parent pour la première fois, nous utilisons l’appel du widget jQuery-UI sous-jacent afin de convertir le DOM du composant en sélecteur de dates. Voir https://jqueryui.com/datepicker/

    La plupart des widgets JavaScript fonctionnent de la même façon. Vous pouvez appliquer la même technique afin d’encapsuler n’importe quel composant et l’importer dans Animate  de la même manière.

  3. Mise à jour : nous remplaçons la fonction de mise à jour (update) et appliquons les propriétés CSS à la balise div conteneur, ainsi que les attributs à l’élément DOM réel.

     Lorsque vous remplacez des API du type attach, detach ou update, évaluez la mise en œuvre par défaut de la classe de base et appelez la mise en œuvre de base au moment approprié ; sinon, l’initialisation du composant risque d’échouer.

 Adobe

Recevez de l’aide plus rapidement et plus facilement

Nouvel utilisateur ?