Cette page a été traduite à partir de l'anglais par la communauté.Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in EnglishAlways switch to English

Attributs universels

Lesattributs 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 tousles é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 etxml: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 ARIArole et les multiples états et propriétésaria-*, utilisés pour garantir l'accessibilité.
Lesattributs 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.

anchorNon 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" outype="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 lessélecteurs de classe ou des fonctions comme la méthodeDocument.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 leHTML et sa représentationDOM pouvant être utilisée par des scripts. Toutes ces données personnalisées sont accessibles via l'interfaceHTMLElement 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 signifiede gauche à droite et doit être utilisé pour les langues écrites de gauche à droite (comme le français) ;
rtl, qui signifiede 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 modecontenteditable.

is

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

Note :Les attributsitem* font partie de lafonctionnalité Microdata HTML WHATWG^(angl.).

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 attributitemprop 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'attributitemscope peuvent être associées à l'objet via unitemref. 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 avecitemtype 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 (commeschema.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 lesitemprop (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 paritemtype 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 validede balise de langue BCP 47.xml:lang est prioritaire sur celui-ci.

nonce

Un nombre unique (« nonce », pournumber used once en anglais) qui peut être utilisé par lapolitique 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 viadisplay: 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'attributpopovertarget) 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 viarole="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'attributslot est affecté au créneau créé par l'élément HTML<slot> dont la valeur de l'attributname correspond à la valeur de l'attributslot.

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 outrue, 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éclarationsCSS à 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 :

unevaleur 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 ;
unevaleur 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 detabindex. 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 typeText 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 ouyes, ce qui indique que l'élément sera traduit.
no, ce qui indique que l'élément ne sera pas traduit.

virtualkeyboardpolicyExpé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'attributcontenteditable 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 laré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 HTMLonvolumechange est accepté par tous les éléments et attache un écouteur d'événement pourvolumechange, mais seuls les éléments média recevront un événementvolumechange déclenché par le navigateur. Pour les autres éléments, vous pouvez uniquement utiliserEventTarget.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 surwindow.

Spécifications

Specification
HTML # attr-is
HTML # attr-nonce
HTML # the-accesskey-attribute
HTML # attr-autocapitalize
HTML # the-title-attribute
HTML # inert-subtrees
HTML # attr-inputmode
HTML # attr-popover-hint
HTML # nonce-does-not-update-dom
HTML # the-popover-attribute
HTML # the-id-attribute
HTML # classes
HTML # dom-fe-autofocus
HTML # writing-suggestions
HTML # the-inert-attribute
HTML # attr-translate
HTML # attr-data-*
HTML # the-style-attribute
HTML # the-hidden-attribute
HTML # attr-tabindex
HTML # attr-lang
HTML # attr-contenteditable
HTML # the-draggable-attribute
HTML # attr-enterkeyhint
HTML # the-dir-attribute
HTML # attr-spellcheck
HTML # attr-slot
HTML # attr-autocorrect
CSS Shadow Parts # part-attr
CSS Shadow Parts # element-attrdef-html-global-exportparts
CSS Style Attributes # style-attribute
VirtualKeyboard API # dom-elementcontenteditable-virtualkeyboardpolicy
DOM # ref-for-dom-element-slot①