<ins>

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

L'élément HTML <ins> représente un fragment de texte qui a été ajouté dans un document.

Note : À l'inverse, on pourra utiliser l'élément <del> afin de représenter un fragment de texte supprimé.

Exemple interactif

Attributs

On peut utiliser les attributs universels pour cet élément.

cite

Cet attribut définit l'URI d'une ressource qui explique la modification (par exemple, un compte-rendu de réunion ou un lien vers un rapport).

datetime

Cet attribut indique la date et l'heure de la modification. La valeur de cet attribut doit être une date valide avec une chaîne de caractères optionnelle pour l'heure. Si la valeur ne peut pas être analysée comme une date, l'indication temporelle sera absente de l'élément. Voir l'article sur les formats pour la représentation d'une date seule ou d'une date avec une heure.

Exemples

HTML

html
<p>Le texte <ins>Ce texte a été ajouté</ins> original.</p>

Résultat

Accessibilité

Par défaut, la plupart des outils d'assistance n'annoncent pas la présence de l'élément ins. On peut le rendre annonçable via la propriété CSS content et grâce aux pseudo-éléments ::before et ::after.

css
ins::before,
ins::after {
  clip-path: inset(100%);
  clip: rect(1px, 1px, 1px, 1px);
  height: 1px;
  overflow: hidden;
  position: absolute;
  white-space: nowrap;
  width: 1px;
}

ins::before {
  content: " [Début de l'insertion]";
}

ins::after {
  content: " [Fin de l'insertion] ";
}

Certaines personnes qui utilisent des lecteurs d'écran désactivent sciemment ces annonces pour éviter une verbosité trop importante. Il est donc important de ne pas abuser de cette technique et de ne l'appliquer qu'à des situations où il est nécessaire de comprendre que du contenu a été inséré.

Résumé technique

Catégories de contenu Contenu phrasé ou contenu de flux.
Contenu autorisé Contenu transparent.
Omission de balise Aucune, la balise ouvrante et la balise fermante doivent être présentes.
Parents autorisés Tout élément qui accepte du contenu phrasé.
Rôles ARIA autorisés Tous les rôles sont autorisés.
Interface DOM HTMLModElement

Spécifications

Specification
HTML Standard
# the-ins-element

Compatibilité des navigateurs

BCD tables only load in the browser

Voir aussi

  • <del> qui permet d'indiquer la suppression d'un fragment dans un document.