SVG avec JavaScript

De EduTech Wiki
Aller à la navigation Aller à la recherche

Cet article est en construction: un auteur est en train de le modifier.

En principe, le ou les auteurs en question devraient bientôt présenter une meilleure version.


Introduction

SVG et JavaScript partagent une évolution assez similaire, car les deux technologies ont connu des hauts et des bas depuis leur créations, mais depuis quelques années elles ont été (ré)découvertes. La combinaison entre les deux représente donc un moyen pour améliorer les applications web interactives notamment en ce qui concerne :

  • Le design d'interfaces utilisateurs "graphiques" (e.g. dessin d'animaux, cartes géographiques, ...) ;
  • La création d'animations "stand-alone" ou qui s'intègrent avec le contenu d'une page web ;
  • La création de représentations graphiques dynamiques (e.g. visualisation de données) ;
  • L'adaptation des éléments graphiques à différents tailles et résolutions des écrans grâce à la nature vectorielle des SVG.

Cet article propose des éléments conceptuels et techniques qui aident l'intégration des deux technologies dans une version plus récente par rapport au Tutoriel SVG dynamique avec DOM.

Prérequis

Pour lire cet article, les connaissances suivantes sont nécessaires :

Il faut également une connaissance de bases des deux technologies, voir à ce propos surtout les pages :

Ces pages proposent également d'autres liens qui peuvent être utiles à la compréhension du contenu de l'article.

Exemples traités dans l'article

Les exemples proposées et analysées dans cet article sont disponibles dans un repository GitHub. Ils suivent une numérotation qui sera utilisée pour les référencer également dans le texte, par exemple: 00-01.

Pour des raisons d'espace, souvent seulement les parties du code indispensables à la compréhension du concept expliqué seront affichées. La référence aux lignes intéressées sera fourni pour pouvoir se repérer dans le code source.

Comprendre l'intégration entre SVG et JavaScript

Le Document Object Model (DOM) d'une page web avec un élément SVG.

L'intégration entre SVG et JavaScript se fait tout simplement à travers le Document Object Model (DOM) de la page. Pour rappelle, le DOM représente l'arborescence hiérarchique des éléments/balises qui composent le code source d'une page HTML.

En raison du fait que SVG utilise une structure de type XML, basée donc sur des éléments/balises emboîtes, un SVG dans un document HTML5 n'est rien d'autres qu'un noeud/element dans le DOM. L'élément SVG "principale" représente le noeud de contact avec le DOM de la page, et tout les éléments qui se trouvent à l'intérieur du code SVG sont des sous-noeuds ou sous-éléments.

De ce fait, on peut accéder à ces éléments selon le même principe qu'on utilise pour accéder à des éléments HTML avec JavaScript. Une fois que la page a été téléchargée par le navigateur et le parsing du DOM effectué, dans le document de la page on retrouve également les éléments SVG.

Il faut cependant faire attention à la modalité d'intégration du SVG dans la page : on ne peut pas intégrer SVG et JavaScript si le SVG est incorporé en tant que image (i.e. à travers la balise <img>). Pour être plus précis, si on incorpore un SVG en tant que "simple" image, c'est comme si on perdait la différence entre une image vectorielle et une image matricielle. En effet, le SVG serait traité comme un bloc unique, sans la possibilité de discriminer parmi les différences éléments/balises qui le composent.

L'intégration entre SVG et JavaScript se fait à travers le DOM de la page. Pour ce faire, il ne faut pas incorporer le SVG en tant que image.

Principes techniques d'intégration entre SVG et JavaScript

Une fois constaté que l'intégration entre SVG et JavaScript se fait plus ou moins de la même manière que entre les éléments HTML et JavaScript, nous allons voir dans les détails comment cette intégration se fait au niveau du code source. Nous allons utiliser quelques exemples de base dans lequel nous verrons :

  1. Comment JavaScript identifie les éléments dans un SVG incorporé dans la page
  2. Comment identifier/sélectionner des caractéristiques/attributs spécifiques des éléments (e.g. la couleur)
  3. Comment manipuler les caractéristiques/attributs d'un élément SVG avec JavaScript (e.g. changer sa couleur)
  4. Comment manipuler un élément SVG à travers un événement déclenché par un élément qui se trouve sur la page, et donc en dehors de l'élément SVG lui-même (e.g. cliquer sur un bouton)
  5. Le processus inverse du point précédent, c'est-à-dire qu'un événement déclenché par un élément dans le SVG peut manipuler un élément HTML qui se trouve dans la page (e.g. modifier le contenu d'un noeud)

Identifier un élément SVG

Dans l'exemple 00-01, l'élément SVG est incorporé tout simplement à travers la balise <svg>...</svg>. À l'intérieur de l'élément svg nous avons placé trois circle avec des tailles et des couleurs différentes. Voici le code limité à la partie qui nous intéresse (Lignes 38-44) :

38 <div>
39     <svg viewBox="0 0 100 100" id="mySVG">
40         <circle cx="50" cy="50" r="40" fill="blue" />
41         <circle cx="50" cy="50" r="25" fill="red" />
42         <circle cx="50" cy="50" r="10" fill="yellow" />
43     </svg>
44 </div>

Il s'agit d'un simple svg avec deux particularités à noter :

  1. Nous n'avons pas déclaré une taille pour l'élément mais exclusivement son viewBox.
    De cette manière le svg va s'adapter directement à la taille de l'élément qui le contient (dans ce cas le div). Si par la suite on veut définir la taille de manière plus spécifique, on pourra le faire à travers du CSS ou avec des attributs de l'élément svg lui-même.
  2. Nous avons attribué à l'élément svg un attribut id="mySVG"
    Comme dans le cas des éléments HTML interactifs, il faut que JavaScript puisse par la suite savoir identifier précisément à quel élément appliquer les instructions. L'identification peut se faire de différentes manières, mais pour cet exemple nous avons choisi la plus simple, avec l'attribut id.

Grâce à l'attribut id, nous pouvons donc créer un script qui identifie l'élément svg afin qu'on puisse par la suite le manipuler avec JavaScript. C'est ce qui est fait à la ligne 69 :

68 //Identify the element and print it to the console
69 var theSVG = document.querySelector("#mySVG");
70 console.log("This is the result of the document.querySelector(\"#mySVG\") instruction.");
71 console.log(theSVG);
72 //Identify the circles
73 var theCircles = document.querySelectorAll("#mySVG circle");
74 console.log("This is the result of the document.querySelectorAll(\"#mySVG circle\") instruction.");
75 console.log(theCircles);

À la ligne 73, par contre, nous utilisons le même principe mais cette fois-ci pour identifier tous les élément circle qui se trouvent à l'intérieur du svg. Si vous testez la

page de l'exemple 00-01

et vous ouvrez la console de votre navigateur, les deux identifications vont être confirmées dans le output :

This is the result of the document.querySelector("#mySVG") instruction.
<svg viewBox="0 0 100 100" id="mySVG">...</svg>
This is the result of the document.querySelectorAll("#mySVG circle") instruction.
NodeList(3) [circle, circle, circle]

En effet, la deuxième instruction qui identifie les cercles obtient comme résultat une liste de noeuds, dans ce cas 3 en correspondance des trois éléments circle contenus dans le svg.

Tout comme pour les éléments HTML, nous avons simplement créé deux références symboliques à travers deux variables dans le code JavaScript :

  1. theSVG se réfère à l'élément svg "principale"
  2. theCircles se réfère aux 3 éléments circle à son intérieur.

Accéder à des caractéristiques/attributs de l'élément SVG

Nous ne sommes pas obligés de passer par l'élément svg "principal" pour identifier des éléments qui se trouve à son intérieur. Dans l'exemple 00-02 nous allons plutôt associer un attribut id différent aux trois cercles :

39 <div>
40     <svg viewBox="0 0 100 100" id="mySVG">
41         <circle cx="50" cy="50" r="40" fill="blue" id="outerCircle" />
42         <circle cx="50" cy="50" r="25" fill="red" id="mediumCircle" />
43         <circle cx="50" cy="50" r="10" fill="yellow" id="innerCircle" />
44     </svg>
45 </div>

Grâce à ce passage, nous pouvons maintenant utiliser les 3 id différentes pour créer des références symboliques aux cercles en JavaScript. Au lieu de créer 3 variables différentes, nous utilisons plutôt un objet JavaScript qui contient trois éléments :

  1. outer se réfère au cercle extérieur (bleu à l'occurrence)
  2. medium se réfère au cercle central (rouge à l'occurrence)
  3. inner se réfère au cercle plus petit (jaune à l'occurrence)

Voici le code pour obtenir cet objet :

69 //Identify the circles
70 var theCircles = {
71     outer: document.querySelector("#outerCircle"),
72     medium: document.querySelector("#mediumCircle"),
73     inner: document.querySelector("#innerCircle")
74 }

Une fois déclaré les références symboliques aux cercles, nous pouvons récupérer par exemple récupérer des informations sur leurs attributs. Il faut faire attention cependant que, contrairement aux éléments HTML, nous ne pouvons pas utiliser la notation element.attribut. Donc le code theCircles.outer.fill n'est pas valable. Il faut utiliser plutôt la méthode getAttribute(), et par conséquent le code correcte serait : theCircles.outer.getAttribute("fill"). Le voici répété pour les trois cercles dans trois instructions de output à la console :

75 //Log the color of the circles
76 console.log(theCircles.outer.getAttribute("fill"));
77 console.log(theCircles.medium.getAttribute("fill"));
78 console.log(theCircles.inner.getAttribute("fill"));

Le résultat de l'output est le suivant :

blue
red
yellow

Manipuler les attributs d'un élément SVG avec JavaScript

Selon le même principe de l'exemple précédent, nous pouvons manipuler les attributs d'un élément contenu dans le svg. Au lieu de getAttribute(attribute-name) il faudra par contre utiliser setAttribute(attribute-name, new-value). Cette méthode s'occupe tout simplement de :

  1. définir quel attribut il faut changer
  2. attribuer une nouvelle valeur à cet attribut

Dans l'exemple 00-03 nous utilisons la méthode setAttribute("fill", "new-color") pour modifier la couleur originale des trois cercles. Le code est limité ici au script JavaScript (lignes 68-77) :

68 //Identify the circles
69 var theCircles = {
70     outer: document.querySelector("#outerCircle"),
71     medium: document.querySelector("#mediumCircle"),
72     inner: document.querySelector("#innerCircle")
73 }
74 //Modify the color of the circles with JavaScript
75 theCircles.outer.setAttribute("fill", "violet");
76 theCircles.medium.setAttribute("fill", "green");
77 theCircles.inner.setAttribute("fill", "black");

En conséquence de ce code qui est exécuté lorsque la page a été affiché dans le navigateur, les trois cercles n'apparaissent pas bleu, rouge et jaune, mais plutôt violet, vert et noir.

Manipuler le SVG à partir d'un événement lié à HTML

Manipuler l'HTML à partir d'un événement lié au SVG