Attributs universels

Les attributs universels sont des attributs communs à l'ensemble des éléments HTML. Ces attributs peuvent donc être ajoutés sur tous les éléments (dans certains cas, les attributs n'auront aucun effet).

Les attributs universels peuvent être définis sur tous les éléments HTML, y compris pour les éléments non définis dans le standard. Autrement dit, les éléments non-standards doivent pouvoir accepter ces attributs. Cela permettra au navigateur de les gérer selon certains des aspects de la spécification. Par exemple, pour un navigateur conforme, un élément <toto hidden>...</toto> sera masqué bien que <toto> ne soit pas un élément HTML valide.

En plus des attributs universels HTML, il existe également les attributs universels suivants :

• xml:lang et xml:base — ceux-ci sont hérités des spécifications XHTML et sont obsolètes, mais conservés pour des raisons de compatibilité.
• L'attribut ARIA role et les multiples états et propriétés aria-*, utilisés pour garantir l'accessibilité.
• Les attributs de gestionnaire d'événements listés ci-dessous.

Liste des attributs universels

accesskey

Fournit une indication pour générer un raccourci clavier pour l'élément courant. Cet attribut se compose d'une liste de caractères séparés par des espaces. Le navigateur doit utiliser le premier caractère qui existe selon la disposition du clavier utilisée.

anchor Non standard

Associe un élément positionné à un élément d'ancre. La valeur de l'attribut correspond à l'id de l'élément auquel vous souhaitez ancrer l'élément positionné. L'élément peut alors être positionné en utilisant le positionnement d'ancre CSS.

autocapitalize

Contrôle si le texte saisi est automatiquement mis en majuscule et, si oui, de quelle manière.

autocorrect

Contrôle si le texte saisi est automatiquement corrigé pour les fautes d'orthographe. Cela peut être appliqué aux éléments ayant du texte éditable sauf pour les éléments HTML <input> avec l'attribut : type="password", type="email" ou type="url".

autofocus

Indique qu'un élément est sélectionné au chargement de la page, ou dès que l'élément HTML <dialog> auquel il appartient est affiché. Cet attribut est un booléen, initialement à false.

class

Une liste de classes séparées par des espaces pour l'élément. Les classes permettent au CSS et à JavaScript de sélectionner et d'accéder à des éléments spécifiques via les sélecteurs de classe ou des fonctions comme la méthode Document.getElementsByClassName().

contenteditable

Un attribut énuméré qui indique si l'élément est éditable par l'utilisateur·ice. Si c'est le cas, le navigateur modifie son interface pour permettre l'édition. L'attribut doit prendre l'une des valeurs suivantes :

• true ou la chaîne de caractères vide, ce qui indique que l'élément est éditable ;
• false, ce qui indique que l'élément n'est pas éditable.
• plaintext-only, ce qui indique que le texte brut de l'élément est éditable, mais la mise en forme enrichie est désactivée.

data-*

Forme une classe d'attributs, appelés attributs de données personnalisés, qui permettent d'échanger des informations propriétaires entre le HTML et sa représentation DOM pouvant être utilisée par des scripts. Toutes ces données personnalisées sont accessibles via l'interface HTMLElement de l'élément sur lequel l'attribut est défini. La propriété HTMLElement.dataset permet d'y accéder.

dir

Un attribut énuméré qui indique la direction du texte de l'élément. Il peut avoir les valeurs suivantes :

• ltr, qui signifie de gauche à droite et doit être utilisé pour les langues écrites de gauche à droite (comme le français) ;
• rtl, qui signifie de droite à gauche et doit être utilisé pour les langues écrites de droite à gauche (comme l'arabe) ;
• auto, qui laisse l'agent utilisateur décider. Il utilise un algorithme basique en analysant les caractères de l'élément jusqu'à trouver un caractère avec une forte direction, puis applique cette direction à l'ensemble de l'élément.

draggable

Un attribut énuméré qui indique si l'élément peut être glissé/déposé grâce à l'API de glisser-déposer. Il peut avoir les valeurs suivantes :

• true, ce qui indique que l'élément peut être glissé/déposé
• false, ce qui indique que l'élément ne peut pas être glissé/déposé.

enterkeyhint

Indique quelle étiquette d'action (ou icône) présenter pour la touche Entrée sur les claviers virtuels.

exportparts

Utilisé pour exporter de façon transitive des parties d'ombre (shadow parts en anglais) d'un arbre imbriqué vers un arbre réel.

hidden

Un attribut énuméré qui indique que l'élément n'est pas encore, ou n'est plus, pertinent. Par exemple, il peut être utilisé pour masquer des éléments de la page qui ne peuvent pas être utilisés tant que la procédure de connexion n'est pas terminée. Le navigateur n'affichera pas ces éléments. Cet attribut ne doit pas être utilisé pour masquer du contenu qui pourrait légitimement être affiché.

id

Définit un identifiant (ID) qui doit être unique dans tout le document. Il sert à identifier l'élément lors de la création de liens (avec un identifiant de fragment), de scripts ou de mise en forme (avec le CSS).

inert

Un booléen qui fait que le navigateur ignore les événements d'entrée utilisateur pour l'élément. Utile lorsque des événements de clic sont présents.

inputmode

Fournit une indication au navigateur sur le type de configuration du clavier virtuel à utiliser lors de la modification de cet élément ou de son contenu. Principalement utilisé sur les éléments HTML <input>, mais utilisable sur n'importe quel élément en mode contenteditable.

is

Permet de définir qu'un élément HTML standard doit se comporter comme un élément personnalisé natif enregistré (voir Utiliser les éléments personnalisés pour plus de détails).

itemid

L'identifiant unique et global d'un objet.

itemprop

Permet d'ajouter des propriétés à un objet. Chaque élément HTML peut avoir un attribut itemprop défini, où itemprop est une paire nom/valeur.

itemref

Les propriétés qui ne sont pas des descendants d'un élément avec l'attribut itemscope peuvent être associées à l'objet via un itemref. Il fournit une liste d'identifiants d'éléments (pas d'itemid) avec des propriétés supplémentaires ailleurs dans le document.

itemscope

itemscope fonctionne généralement avec itemtype pour indiquer que le HTML contenu dans un bloc concerne un objet particulier. itemscope crée l'objet et définit la portée de l'itemtype associée. itemtype est une URL valide d'un vocabulaire (comme schema.org) qui décrit l'objet et le contexte de ses propriétés.

itemtype

Définit l'URL du vocabulaire qui sera utilisé pour définir les itemprop (propriétés d'objet) dans la structure de données. itemscope est utilisé pour définir la portée où le vocabulaire défini par itemtype sera actif.

lang

Aide à définir la langue d'un élément : la langue dans laquelle les éléments non éditables sont écrits, ou la langue dans laquelle les éléments éditables doivent être écrits par l'utilisateur·ice. L'attribut doit contenir une valeur valide de balise de langue BCP 47. xml:lang est prioritaire sur celui-ci.

nonce

Un nombre unique (« nonce », pour number used once en anglais) qui peut être utilisé par la politique de sécurité du contenu pour déterminer si une requête donnée sera autorisée ou non.

part

Une liste de noms de parties séparés par des espaces pour l'élément. Les noms de parties permettent au CSS de cibler et de mettre en forme des éléments spécifiques dans un arbre d'ombre (shadow tree en anglais) via le pseudo-élément ::part.

popover

Utilisé pour désigner un élément comme élément popover (voir l'API Popover). Les éléments popover sont masqués via display: none jusqu'à ce qu'ils soient ouverts via un élément déclencheur/contrôle (par exemple, un <button> ou <input type="button"> avec l'attribut popovertarget) ou un appel à HTMLElement.showPopover().

role

Les rôles définissent la signification sémantique du contenu, permettant aux lecteurs d'écran et autres outils de présenter et de prendre en charge l'interaction avec un objet d'une manière cohérente avec les attentes des utilisateur·ice·s pour ce type d'objet. Les rôles sont ajoutés aux éléments HTML via role="role_type", où role_type est le nom d'un rôle dans la spécification ARIA.

slot

Affecte un créneau dans un arbre DOM d'ombre (shadow DOM en anglais) à un élément : un élément avec l'attribut slot est affecté au créneau créé par l'élément HTML <slot> dont la valeur de l'attribut name correspond à la valeur de l'attribut slot.

spellcheck

Un attribut énuméré qui définit si l'élément peut être vérifié pour les fautes d'orthographe. Il peut avoir les valeurs suivantes :

• une chaîne de caractères vide ou true, ce qui indique que l'élément doit, si possible, être vérifié pour les fautes d'orthographe ;
• false, ce qui indique que l'élément ne doit pas être vérifié pour les fautes d'orthographe.

style

Contient les déclarations CSS à appliquer à l'élément. Il est recommandé de définir les styles dans un ou plusieurs fichiers séparés. Cet attribut et l'élément HTML <style> ont principalement pour but de permettre une mise en forme rapide, par exemple pour des tests.

tabindex

Un attribut entier qui indique si l'élément peut recevoir la sélection (focus en anglais), s'il doit participer à la navigation séquentielle au clavier, et si oui, à quelle position. Il peut prendre plusieurs valeurs :

• une valeur négative signifie que l'élément doit être sélectionnable, mais ne doit pas être accessible via la navigation séquentielle au clavier ;
• 0 signifie que l'élément doit être sélectionnable et accessible via la navigation séquentielle au clavier, mais son ordre relatif est défini par la convention de la plateforme ;
• une valeur positive signifie que l'élément doit être sélectionnable et accessible via la navigation séquentielle au clavier ; l'ordre dans lequel les éléments sont sélectionnés est la valeur croissante de tabindex. Si plusieurs éléments partagent la même valeur de tabindex, leur ordre relatif suit leur position dans le document.

title

Contient un texte représentant une information de conseil liée à l'élément auquel il appartient. Une telle information peut généralement, mais pas nécessairement, être présentée à l'utilisateur·ice sous forme d'infobulle.

translate

Un attribut énuméré utilisé pour définir si les valeurs des attributs et les valeurs des nœuds enfants de type Text doivent être traduites lorsque la page est localisée, ou laissées inchangées. Il peut avoir les valeurs suivantes :

• une chaîne de caractères vide ou yes, ce qui indique que l'élément sera traduit.
• no, ce qui indique que l'élément ne sera pas traduit.

virtualkeyboardpolicy Expérimental

Un attribut énuméré utilisé pour contrôler le comportement du clavier virtuel à l'écran sur des appareils tels que les tablettes, téléphones mobiles ou autres appareils où un clavier matériel peut ne pas être disponible pour les éléments dont le contenu est éditable (par exemple, il s'agit d'un élément HTML <input> ou <textarea>, ou d'un élément avec l'attribut contenteditable activé).

• auto ou une chaîne de caractères vide, ce qui affiche automatiquement le clavier virtuel lorsque l'élément est sélectionné ou tapé.
• manual, ce qui dissocie la sélection et le tap sur l'élément de l'état du clavier virtuel.

writingsuggestions

Un attribut énuméré qui indique si les suggestions d'écriture fournies par le navigateur doivent être activées ou non pour l'élément.

• false, ce qui désactive les suggestions d'écriture du navigateur.
• true ou une chaîne de caractères vide, ce qui active les suggestions d'écriture.

Liste des attributs globaux de gestionnaire d'événements

Les attributs HTML de gestionnaire d'événements sont déconseillés : voir la référence des attributs HTML pour leur fonctionnement.

Bien que les attributs listés ci-dessous s'appliquent à tous les éléments, ils ne sont pas utiles sur tous les éléments. Par exemple, l'attribut HTML onvolumechange est accepté par tous les éléments et attache un écouteur d'événement pour volumechange, mais seuls les éléments média recevront un événement volumechange déclenché par le navigateur. Pour les autres éléments, vous pouvez uniquement utiliser EventTarget.dispatchEvent() pour déclencher manuellement un tel événement. Certains attributs peuvent être spécifiés sur <body>, mais ils écouteront alors les événements sur window.

• onabort
• onanimationcancel
• onanimationend
• onanimationiteration
• onanimationstart
• onauxclick
• onbeforeinput
• onbeforematch
• onbeforetoggle
• onblur
• oncancel
• oncanplay
• oncanplaythrough
• onchange
• onclick
• onclose
• oncommand
• oncontentvisibilityautostatechange
• oncontextlost
• oncontextmenu
• oncontextrestored
• oncopy
• oncuechange
• oncut
• ondblclick
• ondrag
• ondragend
• ondragenter
• ondragleave
• ondragover
• ondragstart
• ondrop
• ondurationchange
• onemptied
• onended
• onerror
• onfocus
• onfocusin
• onfocusout
• onformdata
• onfullscreenchange
• onfullscreenerror
• ongesturechange Non standard
• ongestureend Non standard
• ongesturestart Non standard
• ongotpointercapture
• oninput
• oninvalid
• onkeydown
• onkeypress Obsolète
• onkeyup
• onload
• onloadeddata
• onloadedmetadata
• onloadstart
• onlostpointercapture
• onmousedown
• onmouseenter
• onmouseleave
• onmousemove
• onmouseout
• onmouseover
• onmouseup
• onmousewheel Obsolète Non standard
• onpaste
• onpause
• onplay
• onplaying
• onpointercancel
• onpointerdown
• onpointerenter
• onpointerleave
• onpointermove
• onpointerout
• onpointerover
• onpointerrawupdate
• onpointerup
• onprogress
• onratechange
• onreset
• onresize
• onscroll
• onscrollend
• onscrollsnapchange Expérimental
• onscrollsnapchanging Expérimental
• onsecuritypolicyviolation
• onseeked
• onseeking
• onselect
• onselectionchange
• onselectstart
• onslotchange
• onstalled
• onsubmit
• onsuspend
• ontimeupdate
• ontoggle
• ontouchcancel
• ontouchend
• ontouchmove
• ontouchstart
• ontransitioncancel
• ontransitionend
• ontransitionrun
• ontransitionstart
• onvolumechange
• onwaiting
• onwebkitmouseforcechanged Non standard
• onwebkitmouseforcedown Non standard
• onwebkitmouseforceup Non standard
• onwebkitmouseforcewillbegin Non standard
• onwheel

Spécifications

Compatibilité des navigateurs

Voir aussi

• Les interfaces Element qui permet de manipuler la plupart des attributs globaux.