Liste des attributs HTML

Chaque élément HTML peut avoir un ou plusieurs attributs. Ces attributs sont des valeurs supplémentaires qui permettent de configurer les éléments ou d'adapter leur comportement.

Liste des attributs

Nom de l'attribut Éléments auxquels il s'applique Description
accept <form>, <input> La liste des types acceptés par le serveur. Généralement, il s'agit de types de fichier.
accept-charset <form> La liste des jeux de caractères pris en charge.
accesskey Attribut universel Cet attribut permet de définir un raccourci clavier pour activer un élément ou lui passer le focus.
action <form> L'URI d'un programme qui traite les informations envoyées par le formulaire.
align <applet>, <caption>, <col>, <colgroup>, <hr>, <iframe>, <img>, <table>, <tbody>, <td>, <tfoot> , <th>, <thead>, <tr> Cet attribut définit l'alignement horizontal de l'élément.
alt <applet>, <area>, <img>, <input> Un texte alternatif à afficher lorsque l'élément ne peut pas être affiché.
async <script> Cet attribut indique que le script devrait être exécuté de façon asynchrone.
autocomplete <form>, <input> Cet attribut indique que ces contrôles ou que ce formulaire peuvent être remplis automatiquement par le navigateur.
autofocus <button>, <input>, <keygen>, <select>, <textarea> Cet attribut indique que l'élément doit recevoir le focus automatiquement une fois que la page est chargée.
autoplay <audio>, <video> Cet attribut indique que l'élément audio ou vidéo doit être lancé dès que possible.
autosave <input> Cet attribut indique que, pour une même page, les valeurs précédemment saisies doivent être présentées sous la forme de liste déroulantes.
bgcolor <body>, <col>, <colgroup>, <marquee>, <table>, <tbody>, <tfoot>, <td>, <th>, <tr>

Cet attribut indique la couleur d'arrière-plan pour l'élément.

Note : Cet attribut est un attribut historique. Veuillez utiliser la propriété CSS standard background-color.

border <img>, <object>, <table>

Cet attribut indique la largeur de la bordure.

Note : Cet attribut est un attribut historique. Veuillez utiliser la propriété CSS standard border.

buffered <audio>, <video> Cet attribut contient la valeur de l'intervalle de temps d'ores et déjà mis en mémoire tampon pour le média de l'élément.
challenge <keygen> Une chaîne de challenge qui est envoyée avec la clef publique.
charset <meta>, <script> Cet attribut déclare l'encodage de caractères utilisé pour la page ou le script.
checked <command>, <input> Cet attribut indique si l'élément doit être vérifié au chargement de la page.
cite <blockquote>, <del>, <ins>, <q> Cet attribut est une URI qui pointe vers la source de la citation ou de la modification.
class Attribut universel Cet attribut permet de définir la ou les classes auxquelles appartient un élément afin de le manipuler en script ou de le mettre en forme avec CSS.
code <applet> Cet attribut définit l'URL du fichier de classe qui doit être utilisé pour le chargement et l'exécution de l'applet.
codebase <applet> Cet attribut fournit une URL absolue ou relative du dossier contenant les fichiers .class de l'applet.
color <basefont>, <font>, <hr>

Cet attribut définit la couleur du texte grâce à un nom de couleur ou grâce à un code hexadécimal dans le format #RRGGBB.

Note : Cet attribut est un attribut historique. Veuillez utiliser la propriété CSS standard color.

cols <textarea> Cet attribut définit le nombre de colonnes pour le texte contenu dans un textarea.
colspan <td>, <th> Cet attribut définit le nombre de colonnes sur lequel une cellule doit s'étendre.
content <meta> Une valeur associée avec http-equiv ou name selon le contexte.
contenteditable Attribut universel Cet attribut indique si le contenu de l'élément peut être édité.
contextmenu Attribut universel Cet attribut fait référence à l'identifiant d'un élément <menu> qui sera utilisé comme menu contextuel pour l'élément.
controls <audio>, <video> Cet attribut indique si le navigateur doit afficher les contrôles de lecture du média pour l'utilisateur.
coords <area> Un ensemble de valeurs qui définit les coordonnées de la zone d'intérêt.
data <object> Cet attribut définit l'URL de la ressource.
data-* Attribut universel Grâce aux attributs de donnée, on peut associer des attributs personnalisés afin de transporter des informations spécifiques.
datetime <del>, <ins>, <time> Cet attribut indique la date et l'heure associées à l'élément.
default <track> Cet attribut indique que la piste devrait être activée sauf si les préférences de l'utilisateur indique un autre choix.
defer <script> Cet attribut indique que le script doit être exécuté une fois que la page a été analysée.
dir Attribut universel Cet attribut définit la direction du texte (gauche à droite ou droite à gauche).
dirname <input>, <textarea>  
disabled <button>, <command>, <fieldset>, <input>, <keygen>, <optgroup>, <option>, <select>, <textarea> Cet attribut indique si l'utilisateur peut interagir avec l'élément.
download <a>, <area> Cet attribut indique si l'hyperlien est utilisé afin de télécharger une ressource.
draggable Attribut universel Cet attribut indique si l'élément peut être déplacé/glissé.
dropzone Attribut universel Cet attribut indique si l'élément peut recevoir du contenu suite à un glisser/déposer.
enctype <form> Cet attribut définit le type de contenu des données de formulaire envoyées lorsque la méthode utilisée est POST.
for <label>, <output> Cet attribut décrit l'élément auquel se rapporte l'élément courant.
form <button>, <fieldset>, <input>, <keygen>, <label>, <meter>, <object>, <output>, <progress>, <select>, <textarea> Cet attribut indique le formulaire auquel l'élément se rapporte.
formaction <input>, <button> Cet attribut est l'URI du programme qui traite les données pour ces champs du formulaire. Il prend le pas sur l'attribut action défini pour <form>.
headers <td>, <th> Les identifiants des éléments <th> qui s'appliquent à cet élément.
height <canvas>, <embed>, <iframe>, <img>, <input>, <object>, <video>

Pour ces éléments, cet attribut définit la hauteur occupée par l'élément. Pour les autres éléments, on utilisera height property.

Note : Pour certains éléments comme <div>,cet attribut est un reliquat et ne devrait plus être utilisé. C'est la propriété CSS height qui est la méthode standard pour définir la hauteur d'un élément.

hidden Attribut universel Cet attribut empêche le rendu d'un élément sur une page tout en conservant les éléments fils actifs.
high <meter> Cet attribut indique la borne inférieure de l'intervalle haut.
href <a>, <area>, <base>, <link> L'URL de la ressource liée.
hreflang <a>, <area>, <link> Cet attribut indique la langue utilisé pour la ressource liée.
http-equiv <meta>  
icon <command> Cet attribut indique une image qui représente la commande.
id Attribut universel Cet attribut permet d'identifier un élément d'un document de façon unique. Il est généralement utilisé pour manipuler l'élément avec des scripts ou pour le mettre en forme avec CSS.
integrity <link>, <script>

Une fonctionnalité relative à la sécurité qui permet aux navigateurs de vérifier les fichiers qu'ils récupèrent.

ismap <img> Cet attribut indique que l'image contribue à une mosaïque d'images interactive côté serveur.
itemprop Attribut universel  
keytype <keygen> Cet attribut définit le type de clé qui est généré.
kind <track> Cet attribut définit le type de piste textuelle.
label <track> Cet attribut définit un titre, lisible par un utilisateur, pour la piste.
lang Attribut universel Cet attribut définit la langue utilisée dans l'élément.
language <script> Cet attribut définit le langage de script utilisé dans l'élément.
list <input> Cet attribut constitue une liste d'options prédéfinie qui est suggérée à l'utilisateur.
loop <audio>, <bgsound>, <marquee>, <video> Cet attribut indique si le média courant doit recommencer au début une fois que sa lecture est terminée.
low <meter> Cet attribut indique la borne supérieure de l'intervalle bas.
manifest <html> Cet attribut définit l'URL du manifeste du document pour la gestion du cache.
max <input>, <meter>, <progress> Cet attribut indique la valeur maximale autorisée.
maxlength <input>, <textarea> Cet attribut définit le nombre maximal de caractères autorisé dans l'élément.
media <a>, <area>, <link>, <source>, <style> Cet attribut est indication à propos du type de média pour la ressource liée.
method <form> Cet attribut définit la méthode HTTP à utiliser pour l'envoi des données du formulaire (GET par défaut ou POST)
min <input>, <meter> Cet attribut indique la valeur minimale autorisée.
multiple <input>, <select> Cet attribut indique si plusieurs valeurs peuvent être saisies pour des entrées de type email ou file.
muted <video> Cet attribut indique si le son de la vidéo doit être coupé lorsque la page est chargée initialement.
name <button>, <form>, <fieldset>, <iframe>, <input>, <keygen>, <object>, <output>, <select>, <textarea>, <map>, <meta>, <param> Le nom de l'élément qui peut être utilisé par le serveur pour identifier le champ d'un formulaire.
novalidate <form> Cet attribut indique que les données du formulaire ne doivent pas être validées lors de l'envoi.
open <details> Cet attribut indique si les détails seront affichés lors du chargement de la page.
optimum <meter> Cet attribut indique la valeur numérique optimale.
pattern <input> Cet attribut définit une expression rationnelle contre laquelle valider la valeur de l'élément.
ping <a>, <area>  
placeholder <input>, <textarea> Cet attribut fournit une indication à l'utilisateur sur ce qu'il peut saisir dans le champ.
poster <video> Cet attribut est une URL qui indique l'image à afficher tant que l'utilisateur n'a pas lancé la vidéo ou déplacé le curseur.
preload <audio>, <video> Cet attribut indique si toute ou partie, voire aucune partie de la ressource doit être téléchargée en avance.
radiogroup <command>  
readonly <input>, <textarea> Cet attribut indique si l'élément peut être édité.
rel <a>, <area>, <link> Cet attribut définit la relation entre l'objet cible et l'objet du lien.
required <input>, <select>, <textarea> Cet attribut indique si l'élément doit obligatoirement être renseigné dans le formulaire.
reversed <ol> Cet attribut indique si la liste doit être affichée dans un ordre décroissant plutôt que dans un ordre croissant.
rows <textarea> Cet attribut définit le nombre de lignes pour la zone de texte.
rowspan <td>, <th> Cet attribut définit le nombre de lignes sur lesquelles une cellule doit s'étendre.
sandbox <iframe>  
scope <th>  
scoped <style>  
seamless <iframe>  
selected <option> Cet attribut définit la valeur qui sera sélectionnée au chargement de la page.
shape <a>, <area>  
size <input>, <select> Cet attribut définit la largeur de l'élément en pixels, si l'attribut type de l'élément vaut text ou password, cela correspond au nombre de caractères du champ.
sizes <link>, <img>, <source>  
span <col>, <colgroup>  
spellcheck Attribut universel Cet attribut indique si la vérification orthographique est activée pour l'élément courant.
src <audio>, <embed>, <iframe>, <img>, <input>, <script>, <source>, <track>, <video> Cet attribut indique l'URL du contenu embarqué.
srcdoc <iframe>  
srclang <track>  
srcset <img>  
start <ol> Cet attribut définit le première nombre de la liste si celui-ci est différent de 1.
step <input>  
style Attribut universel Cet attribut définit des styles CSS qui auront la priorité sur ceux définis précédemment. Il ne devrait être utilisé qu'à des fins de tests car il est conseillé d'utiliser un/des fichier(s) à part pour gérer la mise en forme.
summary <table>  
tabindex Attribut universel Cet attribut permet de modifier l'ordre dans la navigation à la tabulation.
target <a>, <area>, <base>, <form>  
title Attribut universel Cet attribut définit un texte expliquant le contenu de l'élément et qui est généralement affiché sous la forme d'une bulle d'information au survol de l'élément.
type <button>, <input>, <command>, <embed>, <object>, <script>, <source>, <style>, <menu> Cet attribut définit le type de l'élément.
usemap <img>, <input>, <object>  
value <button>, <option>, <input>, <li>, <meter>, <progress>, <param> Cet attribut définit la valeur par défaut qui sera affichée dans l'élément au chargement de la page.
width <canvas>, <embed>, <iframe>, <img>, <input>, <object>, <video>

Pour ces éléments, cet attribut définit la largeur occupée sur l'écran.

Note : Pour tous les autres éléments, comme <div>, il faut utiliser la propriété CSS standard width afin de définir la largeur.

wrap <textarea> Cet attribut indique l'utilisation du retour automatique à la ligne pour le texte de l'élément.

Attribut de contenu ou attribut IDL ?

En HTML, la plupart des attributs ont deux aspects : l'attribut de contenu et l'attribut IDL.

L'attribut de contenu est l'attribut qu'on définit via le contenu (le code HTML) et qu'on obtenir et/ou définir via les méthodes element.setAttribute() et element.getAttribute(). L'attribut de contenu sera toujours une chaîne de caractères, y compris lorsque la valeur attendue est un entier. Ainsi, pour indiquer une maxlength d'un élément <input> à 42, on utilisera setAttribute("maxlength", "42") sur cet élément.

L'attribut IDL est également connu sous la forme d'une propriété JavaScript. Ce sont les attributs qu'on peut obtenir ou modifier via JavaScript sous la forme élément.toto. L'attribut IDL utilisera toujours la valeur de l'attribut de contenu sous-jacent, éventuellement en la modifiant pour renvoyer une valeur ou pour la modifier. Autrement dit, les attributs IDL, reflètent les attributs de contenu.

La plupart du temps, les attributs IDL renverront leurs valeurs, telles qu'elles sont utilisées. Par exemple, le type (l'attribut type) par défaut des éléments <input> vaut "text", et si on définit input.type="tototruc", l'élément <input> se comportera comme un élément de type text (en termes d'apparence et de comportement) mais le contenu de l'attribut type sera "tototruc". Cependant, l'attribut de type IDL renverra la chaîne "text".

Les attributs IDL ne sont pas toujours des chaînes de caractères. input.maxlength est un nombre par exemple (un entier long signé pour être précis). Lorsqu'on manipule des attributs IDL on utilisera toujours le type défini pour l'interface. Ainsi, input.maxlength renverra toujours un nombre et si on souhaite le définir, il faudra le faire avec un nombre, si on passe une valeur d'un autre type, cette valeur sera convertie grâce aux mécanismes de conversion habituels de JavaScript.

Les attributs IDL peuvent avoir d'autres types : entiers longs non-signés, URL, booléens, etc. Cependant, il n'existe pas de règle claire qui définisse le comportement des attributs IDL en fonction de l'attribut de contenu. La plupart du temps, les règles de cette spécification seront suivies.

Voir aussi

Étiquettes et contributeurs liés au document

Étiquettes : 
 Contributeurs à cette page : SphinxKnight, louuis, msherefel, tregagnon, FredB
 Dernière mise à jour par : SphinxKnight,