<ins>

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨juillet 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

<p>&ldquo;You're late!&rdquo;</p><del>  <p>&ldquo;I apologize for the delay.&rdquo;</p></del><ins cite="../howtobeawizard.html" datetime="2018-05">  <p>&ldquo;A wizard is never late &hellip;&rdquo;</p></ins>

del,ins {  display: block;  text-decoration: none;  position: relative;}del {  background-color: #fbb;}ins {  background-color: #d4fcbc;}del::before,ins::before {  position: absolute;  left: 0.5rem;  font-family: monospace;}del::before {  content: "−";}ins::before {  content: "+";}p {  margin: 0 1.8rem 0;  font-family: Georgia, serif;  font-size: 1rem;}

Attributs

On peut utiliserles 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 êtreune 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. Voirl'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>

Par défaut, la plupart des outils d'assistance n'annoncent pas la présence de l'élémentins. On peut le rendre annonçable via la propriété CSScontent 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é oucontenu 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 ducontenu phrasé.
Rôles ARIA autorisés	Tous les rôles sont autorisés.
Interface DOM	`HTMLModElement`