<svg>

Des graphiques vectoriels écrits directement dans le code de la page : icônes, logos, graphiques.

Affichage
inline
Balise fermante
Obligatoire
Contenu autorisé
Des éléments SVG, par exemple <rect>, <circle>, <path>, <text>, <g>
Sur cette page

Exemple

#
HTML
<svg width="260" height="120" viewBox="0 0 260 120" role="img" aria-labelledby="badge-title">
  <title id="badge-title">Badge de fin de la formation HTML</title>
  <rect x="4" y="4" width="252" height="112" rx="18" fill="#1e1b4b" stroke="#a78bfa" stroke-width="4" />
  <circle cx="60" cy="60" r="34" fill="#f97316" />
  <path d="M44 61 l11 11 l22 -24" fill="none" stroke="#fff" stroke-width="7" stroke-linecap="round" stroke-linejoin="round" />
  <text x="112" y="56" fill="#f5f3ff" font-size="20" font-family="system-ui, sans-serif">Formation HTML</text>
  <text x="112" y="82" fill="#c4b5fd" font-size="15" font-family="system-ui, sans-serif">terminée</text>
</svg>
Aperçu

Définition et utilisation

#

L’élément <svg> permet d’écrire des graphiques vectoriels directement dans le HTML. À l’intérieur, vous dessinez avec des formes SVG comme <rect> (rectangle), <circle> (cercle), <line> (ligne), <path> (forme quelconque) et <text> (texte). Les graphiques vectoriels restent nets à n’importe quel niveau de zoom et pèsent généralement très peu.

SVG est un langage à part, fondé sur XML, avec ses propres éléments et attributs. Contrairement à <canvas>, chaque forme reste un élément de l’arbre DOM : vous pouvez donc la styler en CSS (fill, stroke), l’animer et gérer un clic comme sur un élément HTML ordinaire.

L’attribut viewBox définit le système de coordonnées interne, et width et height la taille dans la page. Ainsi, une même icône dessinée sur une grille de 24 sur 24 peut faire 16 ou 64 pixels dans la page. Dessinez les icônes qui doivent reprendre la couleur du texte avec fill="currentColor".

Syntaxe

#
Syntaxe
<svg width="…" height="…" viewBox="0 0 … …">
  …
</svg>

Attributs

#
  • width / height

    longueur, p. ex. `24` ou `100%`

    La taille du graphique dans la page. Il est utile de toujours les indiquer, car sans eux la taille dépend du navigateur et du conteneur, et le graphique peut occuper de façon inattendue toute la largeur de la page.
  • viewBox

    min-x min-y largeur hauteur

    Le système de coordonnées interne dans lequel vous dessinez les formes. Avec viewBox="0 0 24 24", le point (12, 12) est toujours le centre du graphique, quelle que soit sa taille d’affichage. Dans l’exemple, la même étoile a trois tailles différentes.
  • fill / stroke

    couleur, `none` ou `currentColor`

    La couleur de remplissage et de contour des formes. Définies sur le <svg> lui-même, elles sont héritées par toutes les formes à l’intérieur. La valeur currentColor reprend la couleur du texte environnant, si bien que l’icône change avec lui.
  • xmlns

    http://www.w3.org/2000/svg

    L’espace de noms SVG. Dans du code HTML, vous pouvez l’omettre, mais dans un fichier .svg autonome il est obligatoire.

L’élément accepte aussi tous les attributs globaux, comme class, id, style ou hidden.

Attributs en pratique

#

viewBox

min-x min-y largeur hauteur

Le système de coordonnées interne dans lequel vous dessinez les formes. Avec viewBox="0 0 24 24", le point (12, 12) est toujours le centre du graphique, quelle que soit sa taille d’affichage. Dans l’exemple, la même étoile a trois tailles différentes.

HTML
<svg width="16" height="16" viewBox="0 0 24 24" aria-hidden="true">
  <polygon points="12,2 14.9,8.6 22,9.3 16.6,14 18.2,21 12,17.3 5.8,21 7.4,14 2,9.3 9.1,8.6" fill="#facc15" />
</svg>
<svg width="32" height="32" viewBox="0 0 24 24" aria-hidden="true">
  <polygon points="12,2 14.9,8.6 22,9.3 16.6,14 18.2,21 12,17.3 5.8,21 7.4,14 2,9.3 9.1,8.6" fill="#facc15" />
</svg>
<svg width="64" height="64" viewBox="0 0 24 24" aria-hidden="true">
  <polygon points="12,2 14.9,8.6 22,9.3 16.6,14 18.2,21 12,17.3 5.8,21 7.4,14 2,9.3 9.1,8.6" fill="#facc15" />
</svg>
Aperçu

fill / stroke

couleur, `none` ou `currentColor`

La couleur de remplissage et de contour des formes. Définies sur le <svg> lui-même, elles sont héritées par toutes les formes à l’intérieur. La valeur currentColor reprend la couleur du texte environnant, si bien que l’icône change avec lui.

HTML
<style>
  .lesson-time { display: flex; align-items: center; gap: 6px; color: #38bdf8; }
</style>
<p class="lesson-time">
  <svg width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" aria-hidden="true">
    <circle cx="12" cy="12" r="9" />
    <path d="M12 7 v5 l3 3" />
  </svg>
  Durée de la leçon : 12 minutes
</p>
Aperçu

Compatibilité des navigateurs

#

Largement disponible

Fonctionne dans tous les navigateurs modernes, y compris sur mobile. Vous pouvez l’utiliser sans crainte.

  • Chrome
  • Edge
  • Firefox
  • Safari

Bonnes pratiques

#
  • Marquez les graphiques porteurs de sens avec role="img" et donnez-leur un nom avec un élément <title> ou un attribut aria-label. Masquez les icônes décoratives aux lecteurs d’écran avec aria-hidden="true".
  • Dessinez les icônes avec fill="currentColor" ou stroke="currentColor". Elles changeront de couleur avec le texte, y compris au survol et en mode sombre.
  • Les fichiers SVG issus de logiciels graphiques contiennent souvent des données inutiles. Avant de les coller dans une page, passez-les dans un optimiseur, par exemple SVGO.

Entrées associées

#

Pratiquer dans les leçons

#

Vous voyez une erreur ou il manque un exemple ? Écrivez-nous.