diff options
Diffstat (limited to 'files/fr/web/html/attributes/index.html')
| -rw-r--r-- | files/fr/web/html/attributes/index.html | 767 |
1 files changed, 767 insertions, 0 deletions
diff --git a/files/fr/web/html/attributes/index.html b/files/fr/web/html/attributes/index.html new file mode 100644 index 0000000000..1b1c140c4e --- /dev/null +++ b/files/fr/web/html/attributes/index.html @@ -0,0 +1,767 @@ +--- +title: Liste des attributs HTML +slug: Web/HTML/Attributs +tags: + - Attribut + - HTML + - Reference + - Web +translation_of: Web/HTML/Attributes +--- +<div>{{HTMLSidebar}}</div> + +<p>Chaque élément HTML peut <a href="/fr/Apprendre/HTML/Balises_HTML">avoir un ou plusieurs attributs</a>. Ces attributs sont des valeurs supplémentaires qui permettent de configurer les éléments ou d'adapter leur comportement.</p> + +<h2 id="Liste_des_attributs">Liste des attributs</h2> + +<table class="standard-table"> + <thead> + <tr> + <th>Nom de l'attribut</th> + <th>Éléments auxquels il s'applique</th> + <th>Description</th> + </tr> + </thead> + <tbody> + <tr> + <td><code>accept</code></td> + <td>{{HTMLElement("form")}}, {{HTMLElement("input")}}</td> + <td>La liste des types acceptés par le serveur. Généralement, il s'agit de types de fichier.</td> + </tr> + <tr> + <td><code>accept-charset</code></td> + <td>{{HTMLElement("form")}}</td> + <td>La liste des jeux de caractères pris en charge.</td> + </tr> + <tr> + <td><code>accesskey</code></td> + <td><a href="/fr/docs/Web/HTML/Attributs_universels" title="en/HTML/Global attributes">Attribut universel</a></td> + <td>Cet attribut permet de définir un raccourci clavier pour activer un élément ou lui passer le focus.</td> + </tr> + <tr> + <td><code>action</code></td> + <td>{{HTMLElement("form")}}</td> + <td>L'URI d'un programme qui traite les informations envoyées par le formulaire.</td> + </tr> + <tr> + <td><code>align</code></td> + <td>{{HTMLElement("applet")}}, {{HTMLElement("caption")}}, {{HTMLElement("col")}}, {{HTMLElement("colgroup")}}, {{HTMLElement("hr")}}, {{HTMLElement("iframe")}}, {{HTMLElement("img")}}, {{HTMLElement("table")}}, {{HTMLElement("tbody")}}, {{HTMLElement("td")}}, {{HTMLElement("tfoot")}} , {{HTMLElement("th")}}, {{HTMLElement("thead")}}, {{HTMLElement("tr")}}</td> + <td>Cet attribut définit l'alignement horizontal de l'élément.</td> + </tr> + <tr> + <td><code>allow</code></td> + <td>{{HTMLElement("iframe")}}</td> + <td>Cet attribut définit les règles des fonctionnalités pour cette <em>iframe</em>.</td> + </tr> + <tr> + <td><code>alt</code></td> + <td>{{HTMLElement("applet")}}, {{HTMLElement("area")}}, {{HTMLElement("img")}}, {{HTMLElement("input")}}</td> + <td>Un texte alternatif à afficher lorsque l'élément ne peut pas être affiché.</td> + </tr> + <tr> + <td><code>async</code></td> + <td>{{HTMLElement("script")}}</td> + <td>Cet attribut indique que le script devrait être exécuté de façon asynchrone.</td> + </tr> + <tr> + <td><code>autocapitalize</code></td> + <td><a href="/fr/docs/Web/HTML/Attributs_universels">Attribut universel</a></td> + <td>Cet attribut contrôle la façon dont un champ texte est saisi en majuscules de façon automatique.</td> + </tr> + <tr> + <td><code>autocomplete</code></td> + <td> + <p>{{HTMLElement("form")}}, {{HTMLElement("input")}}, {{HTMLElement("select")}}, {{HTMLElement("textarea")}}</p> + </td> + <td>Cet attribut indique que ces contrôles ou que ce formulaire peuvent être remplis automatiquement par le navigateur.</td> + </tr> + <tr> + <td><code>autofocus</code></td> + <td>{{HTMLElement("button")}}, {{HTMLElement("input")}}, {{HTMLElement("keygen")}}, {{HTMLElement("select")}}, {{HTMLElement("textarea")}}</td> + <td>Cet attribut indique que l'élément doit recevoir le focus automatiquement une fois que la page est chargée.</td> + </tr> + <tr> + <td><code>autoplay</code></td> + <td>{{HTMLElement("audio")}}, {{HTMLElement("video")}}</td> + <td>Cet attribut indique que l'élément audio ou vidéo doit être lancé dès que possible.</td> + </tr> + <tr> + <td><code>background</code></td> + <td>{{HTMLElement("body")}}, {{HTMLElement("table")}}, {{HTMLElement("td")}}, {{HTMLElement("th")}}</td> + <td> + <p>Définit l'URL vers un fichier qui est une image.</p> + + <p>Note : Bien que les navigateurs et les clients <em>emails</em> prennent en charge cet attribut, cet attribut est obsolète. On utilisera plutôt la propriété {{cssxref("background-image")}}.</p> + </td> + </tr> + <tr> + <td><code>bgcolor</code></td> + <td>{{HTMLElement("body")}}, {{HTMLElement("col")}}, {{HTMLElement("colgroup")}}, {{HTMLElement("marquee")}}, {{HTMLElement("table")}}, {{HTMLElement("tbody")}}, {{HTMLElement("tfoot")}}, {{HTMLElement("td")}}, {{HTMLElement("th")}}, {{HTMLElement("tr")}}</td> + <td> + <p>Cet attribut indique la couleur d'arrière-plan pour l'élément.</p> + + <div class="note"> + <p><strong>Note :</strong> Cet attribut est un attribut historique. Veuillez utiliser la propriété CSS standard {{cssxref("background-color")}}.</p> + </div> + </td> + </tr> + <tr> + <td><code>border</code></td> + <td>{{HTMLElement("img")}}, {{HTMLElement("object")}}, {{HTMLElement("table")}}</td> + <td> + <p>Cet attribut indique la largeur de la bordure.</p> + + <div class="note"> + <p><strong>Note :</strong> Cet attribut est un attribut historique. Veuillez utiliser la propriété CSS standard {{cssxref("border")}}.</p> + </div> + </td> + </tr> + <tr> + <td><code>buffered</code></td> + <td>{{HTMLElement("audio")}}, {{HTMLElement("video")}}</td> + <td>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.</td> + </tr> + <tr> + <td><code>challenge</code></td> + <td>{{HTMLElement("keygen")}}</td> + <td>Une chaîne de challenge qui est envoyée avec la clef publique.</td> + </tr> + <tr> + <td><code>charset</code></td> + <td>{{HTMLElement("meta")}}, {{HTMLElement("script")}}</td> + <td>Cet attribut déclare l'encodage de caractères utilisé pour la page ou le script.</td> + </tr> + <tr> + <td><code>checked</code></td> + <td>{{HTMLElement("command")}}, {{HTMLElement("input")}}</td> + <td>Cet attribut indique si l'élément doit être vérifié au chargement de la page.</td> + </tr> + <tr> + <td><code>cite</code></td> + <td>{{HTMLElement("blockquote")}}, {{HTMLElement("del")}}, {{HTMLElement("ins")}}, {{HTMLElement("q")}}</td> + <td>Cet attribut est une URI qui pointe vers la source de la citation ou de la modification.</td> + </tr> + <tr> + <td><code>class</code></td> + <td><a href="/fr/docs/Web/HTML/Attributs_universels" title="en/HTML/Global attributes">Attribut universel</a></td> + <td>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.</td> + </tr> + <tr> + <td><code>code</code></td> + <td>{{HTMLElement("applet")}}</td> + <td>Cet attribut définit l'URL du fichier de classe qui doit être utilisé pour le chargement et l'exécution de l'applet.</td> + </tr> + <tr> + <td><code>codebase</code></td> + <td>{{HTMLElement("applet")}}</td> + <td>Cet attribut fournit une URL absolue ou relative du dossier contenant les fichiers <code>.class</code> de l'applet.</td> + </tr> + <tr> + <td><code>color</code></td> + <td>{{HTMLElement("basefont")}}, {{HTMLElement("font")}}, {{HTMLElement("hr")}}</td> + <td> + <p>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.</p> + + <div class="note"> + <p><strong>Note :</strong> Cet attribut est un attribut historique. Veuillez utiliser la propriété CSS standard {{cssxref("color")}}.</p> + </div> + </td> + </tr> + <tr> + <td><code>cols</code></td> + <td>{{HTMLElement("textarea")}}</td> + <td>Cet attribut définit le nombre de colonnes pour le texte contenu dans un<code> textarea</code>.</td> + </tr> + <tr> + <td><code>colspan</code></td> + <td>{{HTMLElement("td")}}, {{HTMLElement("th")}}</td> + <td>Cet attribut définit le nombre de colonnes sur lequel une cellule doit s'étendre.</td> + </tr> + <tr> + <td><code>content</code></td> + <td>{{HTMLElement("meta")}}</td> + <td>Une valeur associée avec <code>http-equiv</code> ou <code>name</code> selon le contexte.</td> + </tr> + <tr> + <td><code>contenteditable</code></td> + <td><a href="/fr/docs/Web/HTML/Attributs_universels" title="en/HTML/Global attributes">Attribut universel</a></td> + <td>Cet attribut indique si le contenu de l'élément peut être édité.</td> + </tr> + <tr> + <td><code>contextmenu</code></td> + <td><a href="/fr/docs/Web/HTML/Attributs_universels" title="en/HTML/Global attributes">Attribut universel</a></td> + <td>Cet attribut fait référence à l'identifiant d'un élément {{HTMLElement("menu")}} qui sera utilisé comme menu contextuel pour l'élément.</td> + </tr> + <tr> + <td><code>controls</code></td> + <td>{{HTMLElement("audio")}}, {{HTMLElement("video")}}</td> + <td>Cet attribut indique si le navigateur doit afficher les contrôles de lecture du média pour l'utilisateur.</td> + </tr> + <tr> + <td><code>coords</code></td> + <td>{{HTMLElement("area")}}</td> + <td>Un ensemble de valeurs qui définit les coordonnées de la zone d'intérêt.</td> + </tr> + <tr> + <td><code>crossorigin</code></td> + <td>{{HTMLElement("audio")}}, {{HTMLElement("img")}}, {{HTMLElement("link")}}, {{HTMLElement("script")}}, {{HTMLElement("video")}}</td> + <td>Cet attribut gère les requêtes de différentes origines.</td> + </tr> + <tr> + <td><code>csp</code> {{experimental_inline}}</td> + <td>{{HTMLElement("iframe")}}</td> + <td>Cet attribut définit la politique de sécurité de contenu que le document intégré doit respecter.</td> + </tr> + <tr> + <td><code>data</code></td> + <td>{{HTMLElement("object")}}</td> + <td>Cet attribut définit l'URL de la ressource.</td> + </tr> + <tr> + <td><code>data-*</code></td> + <td><a href="/fr/docs/Web/HTML/Attributs_universels" title="en/HTML/Global attributes">Attribut universel</a></td> + <td>Grâce aux attributs de donnée, on peut associer des attributs personnalisés afin de transporter des informations spécifiques.</td> + </tr> + <tr> + <td><code>datetime</code></td> + <td>{{HTMLElement("del")}}, {{HTMLElement("ins")}}, {{HTMLElement("time")}}</td> + <td>Cet attribut indique la date et l'heure associées à l'élément.</td> + </tr> + <tr> + <td><code>decoding</code></td> + <td>{{HTMLElement("img")}}</td> + <td>Cet attribut indique la méthode préférée pour décoder l'image.</td> + </tr> + <tr> + <td><code>default</code></td> + <td>{{HTMLElement("track")}}</td> + <td>Cet attribut indique que la piste devrait être activée sauf si les préférences de l'utilisateur indique un autre choix.</td> + </tr> + <tr> + <td><code>defer</code></td> + <td>{{HTMLElement("script")}}</td> + <td>Cet attribut indique que le script doit être exécuté une fois que la page a été analysée.</td> + </tr> + <tr> + <td><code>dir</code></td> + <td><a href="/fr/docs/Web/HTML/Attributs_universels" title="en/HTML/Global attributes">Attribut universel</a></td> + <td>Cet attribut définit la direction du texte (gauche à droite ou droite à gauche).</td> + </tr> + <tr> + <td><code>dirname</code></td> + <td>{{HTMLElement("input")}}, {{HTMLElement("textarea")}}</td> + <td></td> + </tr> + <tr> + <td><code>disabled</code></td> + <td>{{HTMLElement("button")}}, {{HTMLElement("command")}}, {{HTMLElement("fieldset")}}, {{HTMLElement("input")}}, {{HTMLElement("keygen")}}, {{HTMLElement("optgroup")}}, {{HTMLElement("option")}}, {{HTMLElement("select")}}, {{HTMLElement("textarea")}}</td> + <td>Cet attribut indique si l'utilisateur peut interagir avec l'élément.</td> + </tr> + <tr> + <td><code>download</code></td> + <td>{{HTMLElement("a")}}, {{HTMLElement("area")}}</td> + <td>Cet attribut indique si l'hyperlien est utilisé afin de télécharger une ressource.</td> + </tr> + <tr> + <td><code>draggable</code></td> + <td><a href="/fr/docs/Web/HTML/Attributs_universels" title="en/HTML/Global attributes">Attribut universel</a></td> + <td>Cet attribut indique si l'élément peut être déplacé/glissé.</td> + </tr> + <tr> + <td><code>dropzone</code></td> + <td><a href="/fr/docs/Web/HTML/Attributs_universels" title="en/HTML/Global attributes">Attribut universel</a></td> + <td>Cet attribut indique si l'élément peut recevoir du contenu suite à un glisser/déposer.</td> + </tr> + <tr> + <td><code>enctype</code></td> + <td>{{HTMLElement("form")}}</td> + <td>Cet attribut définit le type de contenu des données de formulaire envoyées lorsque la méthode utilisée est <code>POST</code>.</td> + </tr> + <tr> + <td><code>enterkeyhint</code> {{experimental_inline}}</td> + <td>{{HTMLElement("textarea")}}, <code>contenteditable</code></td> + <td>Cet attribut indique le libellé ou l'icône à afficher sur la touche entrée des clavier virtuels. Cet attribut peut être utilisé sur les contrôles de formulaires ou sur les éléments qui sont éditables (par exemple avec l'attribut <code>contenteditable</code>).</td> + </tr> + <tr> + <td><code>for</code></td> + <td>{{HTMLElement("label")}}, {{HTMLElement("output")}}</td> + <td>Cet attribut décrit l'élément auquel se rapporte l'élément courant.</td> + </tr> + <tr> + <td><code>form</code></td> + <td>{{HTMLElement("button")}}, {{HTMLElement("fieldset")}}, {{HTMLElement("input")}}, {{HTMLElement("keygen")}}, {{HTMLElement("label")}}, {{HTMLElement("meter")}}, {{HTMLElement("object")}}, {{HTMLElement("output")}}, {{HTMLElement("progress")}}, {{HTMLElement("select")}}, {{HTMLElement("textarea")}}</td> + <td>Cet attribut indique le formulaire auquel l'élément se rapporte.</td> + </tr> + <tr> + <td><code>formaction</code></td> + <td>{{HTMLElement("input")}}, {{HTMLElement("button")}}</td> + <td>Cet attribut est l'URI du programme qui traite les données pour ces champs du formulaire. Il prend le pas sur l'attribut <code>action</code> défini pour {{HTMLElement("form")}}.</td> + </tr> + <tr> + <td><code>formenctype</code></td> + <td>{{HTMLElement("input")}}, {{HTMLElement("button")}}</td> + <td>Si le bouton ou le champ sert à l'envoi (<code>type="submit"</code>), cet attribut indique l'encodage utilisé pour l'envoi des données. Si cet attribut est indiqué, il surcharge l'attribut <code>enctype</code> du formulaire auquel est rattaché le bouton/champ.</td> + </tr> + <tr> + <td><code>formmethod</code></td> + <td>{{HTMLElement("input")}}, {{HTMLElement("button")}}</td> + <td>Si le bouton ou le champ sert à l'envoi (<code>type="submit"</code>), cet attribut indique la méthode HTTP pour envoyer les données (<code>GET</code>, <code>POST</code>, etc.). Si cet attribut est indiqué, il surcharge l'attribut <code>method</code> du formulaire auquel est rattaché le bouton/champ.</td> + </tr> + <tr> + <td><code>formnovalidate</code></td> + <td>{{HTMLElement("input")}}, {{HTMLElement("button")}}</td> + <td>Si le bouton ou le champ sert à l'envoi (<code>type="submit"</code>), cet attribut booléen indique que le formulaire ne doit pas être validé à l'envoi. Si cet attribut est indiqué, il surcharge l'attribut <code>novalidate</code> du formulaire auquel est rattaché le bouton/champ.</td> + </tr> + <tr> + <td><code>formtarget</code></td> + <td>{{HTMLElement("input")}}, {{HTMLElement("button")}}</td> + <td>Si le bouton ou le champ sert à l'envoi (<code>type="submit"</code>), cet attribut indique le contexte de navigation (onglet, fenêtre ou <em>iframe</em>) dans lequel afficher la réponse après l'envoi du formulaire. Si cet attribut est indiqué, il surcharge l'attribut <code>target</code> du formulaire auquel est rattaché le bouton/champ.</td> + </tr> + <tr> + <td><code>headers</code></td> + <td>{{HTMLElement("td")}}, {{HTMLElement("th")}}</td> + <td>Les identifiants des éléments <code><th></code> qui s'appliquent à cet élément.</td> + </tr> + <tr> + <td><code>height</code></td> + <td>{{HTMLElement("canvas")}}, {{HTMLElement("embed")}}, {{HTMLElement("iframe")}}, {{HTMLElement("img")}}, {{HTMLElement("input")}}, {{HTMLElement("object")}}, {{HTMLElement("video")}}</td> + <td> + <p>Pour ces éléments, cet attribut définit la hauteur occupée par l'élément. Pour les autres éléments, on utilisera {{cssxref("height")}} property.</p> + + <div class="note"> + <p><strong>Note :</strong> Pour certains éléments comme {{HTMLElement("div")}},cet attribut est un reliquat et ne devrait plus être utilisé. C'est la propriété CSS {{cssxref("height")}} qui est la méthode standard pour définir la hauteur d'un élément.</p> + </div> + </td> + </tr> + <tr> + <td><code>hidden</code></td> + <td><a href="/fr/docs/Web/HTML/Attributs_universels" title="en/HTML/Global attributes">Attribut universel</a></td> + <td>Cet attribut empêche le rendu d'un élément sur une page tout en conservant les éléments fils actifs.</td> + </tr> + <tr> + <td><code>high</code></td> + <td>{{HTMLElement("meter")}}</td> + <td>Cet attribut indique la borne inférieure de l'intervalle haut.</td> + </tr> + <tr> + <td><code>href</code></td> + <td>{{HTMLElement("a")}}, {{HTMLElement("area")}}, {{HTMLElement("base")}}, {{HTMLElement("link")}}</td> + <td>L'URL de la ressource liée.</td> + </tr> + <tr> + <td><code>hreflang</code></td> + <td>{{HTMLElement("a")}}, {{HTMLElement("area")}}, {{HTMLElement("link")}}</td> + <td>Cet attribut indique la langue utilisé pour la ressource liée.</td> + </tr> + <tr> + <td><code>http-equiv</code></td> + <td>{{HTMLElement("meta")}}</td> + <td></td> + </tr> + <tr> + <td><code>icon</code></td> + <td>{{HTMLElement("command")}}</td> + <td>Cet attribut indique une image qui représente la commande.</td> + </tr> + <tr> + <td><code>id</code></td> + <td><a href="/fr/docs/Web/HTML/Attributs_universels" title="en/HTML/Global attributes">Attribut universel</a></td> + <td>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.</td> + </tr> + <tr> + <td><code>importance</code> {{experimental_inline}}</td> + <td>{{HTMLElement("iframe")}}, {{HTMLElement("img")}}, {{HTMLElement("link")}}, {{HTMLElement("script")}}</td> + <td>Cet attribut indique la priorité relative pour la récupération (<em>fetch</em>) des ressources.</td> + </tr> + <tr> + <td><code>integrity</code></td> + <td>{{HTMLElement("link")}}, {{HTMLElement("script")}}</td> + <td> + <p>Une fonctionnalité relative à la sécurité qui permet aux navigateurs de vérifier les fichiers qu'ils récupèrent.</p> + </td> + </tr> + <tr> + <td><code>intrinsicsize</code> {{experimental_inline}}</td> + <td>{{HTMLElement("img")}}</td> + <td>Cet attribut indique au navigateur qu'il faut ignorer la taille intrinsèque de l'image et qu'il faut utiliser la taille indiquée avec les attributs.</td> + </tr> + <tr> + <td><code>inputmode</code></td> + <td>{{HTMLElement("textarea")}}, <code>contenteditable</code></td> + <td>Cet attribut fournit une indication sur le type de donnée qui pourrait être saisi par l'utilisateur lors de l'édition du formulaire ou de l'élément. Cet attribut peut être utilisé sur les contrôles de formulaires ou sur les éléments qui sont éditables (par exemple avec l'attribut <code>contenteditable</code>).</td> + </tr> + <tr> + <td><code>ismap</code></td> + <td>{{HTMLElement("img")}}</td> + <td>Cet attribut indique que l'image contribue à une mosaïque d'images interactive côté serveur.</td> + </tr> + <tr> + <td><code>itemprop</code></td> + <td><a href="/fr/docs/Web/HTML/Attributs_universels" title="en/HTML/Global attributes">Attribut universel</a></td> + <td></td> + </tr> + <tr> + <td><code>keytype</code></td> + <td>{{HTMLElement("keygen")}}</td> + <td>Cet attribut définit le type de clé qui est généré.</td> + </tr> + <tr> + <td><code>kind</code></td> + <td>{{HTMLElement("track")}}</td> + <td>Cet attribut définit le type de piste textuelle.</td> + </tr> + <tr> + <td><code>label</code></td> + <td>{{HTMLElement("optgroup")}}, {{HTMLElement("option")}}, {{HTMLElement("track")}}</td> + <td>Cet attribut définit un titre, lisible par un utilisateur, pour l'élément.</td> + </tr> + <tr> + <td><code>lang</code></td> + <td><a href="/fr/docs/Web/HTML/Attributs_universels" title="en/HTML/Global attributes">Attribut universel</a></td> + <td>Cet attribut définit la langue utilisée dans l'élément.</td> + </tr> + <tr> + <td><code>language</code></td> + <td>{{HTMLElement("script")}}</td> + <td>Cet attribut définit le langage de script utilisé dans l'élément.</td> + </tr> + <tr> + <td><code>loading</code> {{experimental_inline}}</td> + <td>{{HTMLElement("img")}}, {{HTMLElement("iframe")}}</td> + <td>Cet attribut indique que l'élément doit être chargé à la demande.</td> + </tr> + <tr> + <td><code>list</code></td> + <td>{{HTMLElement("input")}}</td> + <td>Cet attribut constitue une liste d'options prédéfinie qui est suggérée à l'utilisateur.</td> + </tr> + <tr> + <td><code>loop</code></td> + <td>{{HTMLElement("audio")}}, {{HTMLElement("bgsound")}}, {{HTMLElement("marquee")}}, {{HTMLElement("video")}}</td> + <td>Cet attribut indique si le média courant doit recommencer au début une fois que sa lecture est terminée.</td> + </tr> + <tr> + <td><code>low</code></td> + <td>{{HTMLElement("meter")}}</td> + <td>Cet attribut indique la borne supérieure de l'intervalle bas.</td> + </tr> + <tr> + <td><code>manifest</code></td> + <td>{{HTMLElement("html")}}</td> + <td> + <p>Cet attribut définit l'URL du manifeste du document pour la gestion du cache.</p> + + <p>Cet attribut est obsolète, on utilisera plutôt <code><link rel="manifest"></code>.</p> + </td> + </tr> + <tr> + <td><code>max</code></td> + <td>{{HTMLElement("input")}}, {{HTMLElement("meter")}}, {{HTMLElement("progress")}}</td> + <td>Cet attribut indique la valeur maximale autorisée.</td> + </tr> + <tr> + <td><code>maxlength</code></td> + <td>{{HTMLElement("input")}}, {{HTMLElement("textarea")}}</td> + <td>Cet attribut définit le nombre maximal de caractères autorisé dans l'élément.</td> + </tr> + <tr> + <td><code>minlength</code></td> + <td>{{HTMLElement("input")}}, {{HTMLElement("textarea")}}</td> + <td>Cet attribut définit le nombre minimal de caractères qui doivent être saisis dans l'élément.</td> + </tr> + <tr> + <td><code>media</code></td> + <td>{{HTMLElement("a")}}, {{HTMLElement("area")}}, {{HTMLElement("link")}}, {{HTMLElement("source")}}, {{HTMLElement("style")}}</td> + <td>Cet attribut est indication à propos du type de média pour la ressource liée.</td> + </tr> + <tr> + <td><code>method</code></td> + <td>{{HTMLElement("form")}}</td> + <td>Cet attribut définit la méthode <a href="/fr/docs/HTTP">HTTP</a> à utiliser pour l'envoi des données du formulaire (<code>GET</code> par défaut ou <code>POST</code>)</td> + </tr> + <tr> + <td><code>min</code></td> + <td>{{HTMLElement("input")}}, {{HTMLElement("meter")}}</td> + <td>Cet attribut indique la valeur minimale autorisée.</td> + </tr> + <tr> + <td><code>multiple</code></td> + <td>{{HTMLElement("input")}}, {{HTMLElement("select")}}</td> + <td>Cet attribut indique si plusieurs valeurs peuvent être saisies pour des entrées de type <code>email</code> ou <code>file</code>.</td> + </tr> + <tr> + <td><code>muted</code></td> + <td>{{HTMLElement("audio")}},{{HTMLElement("video")}}</td> + <td>Cet attribut indique si le son de la vidéo doit être coupé lorsque la page est chargée initialement.</td> + </tr> + <tr> + <td><code>name</code></td> + <td>{{HTMLElement("button")}}, {{HTMLElement("form")}}, {{HTMLElement("fieldset")}}, {{HTMLElement("iframe")}}, {{HTMLElement("input")}}, {{HTMLElement("keygen")}}, {{HTMLElement("object")}}, {{HTMLElement("output")}}, {{HTMLElement("select")}}, {{HTMLElement("textarea")}}, {{HTMLElement("map")}}, {{HTMLElement("meta")}}, {{HTMLElement("param")}}</td> + <td>Le nom de l'élément qui peut être utilisé par le serveur pour identifier le champ d'un formulaire.</td> + </tr> + <tr> + <td><code>novalidate</code></td> + <td>{{HTMLElement("form")}}</td> + <td>Cet attribut indique que les données du formulaire ne doivent pas être validées lors de l'envoi.</td> + </tr> + <tr> + <td><code>open</code></td> + <td>{{HTMLElement("details")}}</td> + <td>Cet attribut indique si les détails seront affichés lors du chargement de la page.</td> + </tr> + <tr> + <td><code>optimum</code></td> + <td>{{HTMLElement("meter")}}</td> + <td>Cet attribut indique la valeur numérique optimale.</td> + </tr> + <tr> + <td><code>pattern</code></td> + <td>{{HTMLElement("input")}}</td> + <td>Cet attribut définit une expression rationnelle contre laquelle valider la valeur de l'élément.</td> + </tr> + <tr> + <td><code>ping</code></td> + <td>{{HTMLElement("a")}}, {{HTMLElement("area")}}</td> + <td></td> + </tr> + <tr> + <td><code>placeholder</code></td> + <td>{{HTMLElement("input")}}, {{HTMLElement("textarea")}}</td> + <td>Cet attribut fournit une indication à l'utilisateur sur ce qu'il peut saisir dans le champ.</td> + </tr> + <tr> + <td><code>poster</code></td> + <td>{{HTMLElement("video")}}</td> + <td>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.</td> + </tr> + <tr> + <td><code>preload</code></td> + <td>{{HTMLElement("audio")}}, {{HTMLElement("video")}}</td> + <td>Cet attribut indique si toute ou partie, voire aucune partie de la ressource doit être téléchargée en avance.</td> + </tr> + <tr> + <td><code>radiogroup</code></td> + <td>{{HTMLElement("command")}}</td> + <td></td> + </tr> + <tr> + <td><code>readonly</code></td> + <td>{{HTMLElement("input")}}, {{HTMLElement("textarea")}}</td> + <td>Cet attribut indique si l'élément peut être édité.</td> + </tr> + <tr> + <td><code>referrerpolicy</code></td> + <td>{{HTMLElement("a")}}, {{HTMLElement("area")}}, {{HTMLElement("iframe")}}, {{HTMLElement("img")}}, {{HTMLElement("link")}}, {{HTMLElement("script")}}</td> + <td>Définit le référent (<em>referrer</em>) envoyé lors de la récupération de la ressource.</td> + </tr> + <tr> + <td><code>rel</code></td> + <td>{{HTMLElement("a")}}, {{HTMLElement("area")}}, {{HTMLElement("link")}}</td> + <td>Cet attribut définit la relation entre l'objet cible et l'objet du lien.</td> + </tr> + <tr> + <td><code>required</code></td> + <td>{{HTMLElement("input")}}, {{HTMLElement("select")}}, {{HTMLElement("textarea")}}</td> + <td>Cet attribut indique si l'élément doit obligatoirement être renseigné dans le formulaire.</td> + </tr> + <tr> + <td><code>reversed</code></td> + <td>{{HTMLElement("ol")}}</td> + <td>Cet attribut indique si la liste doit être affichée dans un ordre décroissant plutôt que dans un ordre croissant.</td> + </tr> + <tr> + <td><code>rows</code></td> + <td>{{HTMLElement("textarea")}}</td> + <td>Cet attribut définit le nombre de lignes pour la zone de texte.</td> + </tr> + <tr> + <td><code>rowspan</code></td> + <td>{{HTMLElement("td")}}, {{HTMLElement("th")}}</td> + <td>Cet attribut définit le nombre de lignes sur lesquelles une cellule doit s'étendre.</td> + </tr> + <tr> + <td><code>sandbox</code></td> + <td>{{HTMLElement("iframe")}}</td> + <td>Empêche un élément chargé dans une <em>iframe</em> d'utiliser certaines fonctionnalités (envoyer des formulaires ou ouvrir de nouvelles fenêtres par exemples).</td> + </tr> + <tr> + <td><code>scope</code></td> + <td>{{HTMLElement("th")}}</td> + <td>Définit les cellules sur lesquelles porte la cellule d'en-tête.</td> + </tr> + <tr> + <td><code>scoped</code></td> + <td>{{HTMLElement("style")}}</td> + <td></td> + </tr> + <tr> + <td><code>selected</code></td> + <td>{{HTMLElement("option")}}</td> + <td>Cet attribut définit la valeur qui sera sélectionnée au chargement de la page.</td> + </tr> + <tr> + <td><code>shape</code></td> + <td>{{HTMLElement("a")}}, {{HTMLElement("area")}}</td> + <td></td> + </tr> + <tr> + <td><code>size</code></td> + <td>{{HTMLElement("input")}}, {{HTMLElement("select")}}</td> + <td>Cet attribut définit la largeur de l'élément en pixels, si l'attribut <code>type</code> de l'élément vaut <code>text</code> ou <code>password</code>, cela correspond au nombre de caractères du champ.</td> + </tr> + <tr> + <td><code>sizes</code></td> + <td>{{HTMLElement("link")}}, {{HTMLElement("img")}}, {{HTMLElement("source")}}</td> + <td></td> + </tr> + <tr> + <td><code>slot</code></td> + <td><a href="/fr/docs/Web/HTML/Attributs_universels" title="en/HTML/Global attributes">Attribut universel</a></td> + <td>Cet attribut affecte un créneau pour un élément dans le <em>shadow DOM</em>.</td> + </tr> + <tr> + <td><code>span</code></td> + <td>{{HTMLElement("col")}}, {{HTMLElement("colgroup")}}</td> + <td></td> + </tr> + <tr> + <td><code>spellcheck</code></td> + <td><a href="/fr/docs/Web/HTML/Attributs_universels" title="en/HTML/Global attributes">Attribut universel</a></td> + <td>Cet attribut indique si la vérification orthographique est activée pour l'élément courant.</td> + </tr> + <tr> + <td><code>src</code></td> + <td>{{HTMLElement("audio")}}, {{HTMLElement("embed")}}, {{HTMLElement("iframe")}}, {{HTMLElement("img")}}, {{HTMLElement("input")}}, {{HTMLElement("script")}}, {{HTMLElement("source")}}, {{HTMLElement("track")}}, {{HTMLElement("video")}}</td> + <td>Cet attribut indique l'URL du contenu embarqué.</td> + </tr> + <tr> + <td><code>srcdoc</code></td> + <td>{{HTMLElement("iframe")}}</td> + <td></td> + </tr> + <tr> + <td><code>srclang</code></td> + <td>{{HTMLElement("track")}}</td> + <td></td> + </tr> + <tr> + <td><code>srcset</code></td> + <td>{{HTMLElement("img")}}</td> + <td></td> + </tr> + <tr> + <td><code>start</code></td> + <td>{{HTMLElement("ol")}}</td> + <td>Cet attribut définit le première nombre de la liste si celui-ci est différent de 1.</td> + </tr> + <tr> + <td><code>step</code></td> + <td>{{HTMLElement("input")}}</td> + <td></td> + </tr> + <tr> + <td><code>style</code></td> + <td><a href="/fr/docs/Web/HTML/Attributs_universels" title="en/HTML/Global attributes">Attribut universel</a></td> + <td>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.</td> + </tr> + <tr> + <td><code>summary</code></td> + <td>{{HTMLElement("table")}}</td> + <td></td> + </tr> + <tr> + <td><code>tabindex</code></td> + <td><a href="/fr/docs/Web/HTML/Attributs_universels" title="en/HTML/Global attributes">Attribut universel</a></td> + <td>Cet attribut permet de modifier l'ordre dans la navigation à la tabulation.</td> + </tr> + <tr> + <td><code>target</code></td> + <td>{{HTMLElement("a")}}, {{HTMLElement("area")}}, {{HTMLElement("base")}}, {{HTMLElement("form")}}</td> + <td></td> + </tr> + <tr> + <td><code>title</code></td> + <td><a href="/fr/docs/Web/HTML/Attributs_universels" title="en/HTML/Global attributes">Attribut universel</a></td> + <td>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.</td> + </tr> + <tr> + <td><code>translate</code></td> + <td><a href="/fr/docs/Web/HTML/Attributs_universels" title="en/HTML/Global attributes">Attribut universel</a></td> + <td>Cet attribut indique si le contenu textuel de l'élément doit être traduit ou non.</td> + </tr> + <tr> + <td><code>type</code></td> + <td>{{HTMLElement("button")}}, {{HTMLElement("input")}}, {{HTMLElement("command")}}, {{HTMLElement("embed")}}, {{HTMLElement("object")}}, {{HTMLElement("script")}}, {{HTMLElement("source")}}, {{HTMLElement("style")}}, {{HTMLElement("menu")}}</td> + <td>Cet attribut définit le type de l'élément.</td> + </tr> + <tr> + <td><code>usemap</code></td> + <td>{{HTMLElement("img")}}, {{HTMLElement("input")}}, {{HTMLElement("object")}}</td> + <td></td> + </tr> + <tr> + <td><code>value</code></td> + <td>{{HTMLElement("button")}}, {{HTMLElement("option")}}, {{HTMLElement("input")}}, {{HTMLElement("li")}}, {{HTMLElement("meter")}}, {{HTMLElement("progress")}}, {{HTMLElement("param")}}</td> + <td>Cet attribut définit la valeur par défaut qui sera affichée dans l'élément au chargement de la page.</td> + </tr> + <tr> + <td><code>width</code></td> + <td>{{HTMLElement("canvas")}}, {{HTMLElement("embed")}}, {{HTMLElement("iframe")}}, {{HTMLElement("img")}}, {{HTMLElement("input")}}, {{HTMLElement("object")}}, {{HTMLElement("video")}}</td> + <td> + <p>Pour ces éléments, cet attribut définit la largeur occupée sur l'écran.</p> + + <div class="note"> + <p><strong>Note :</strong> Pour tous les autres éléments, comme {{HTMLElement("div")}}, il faut utiliser la propriété CSS standard {{cssxref("width")}} afin de définir la largeur.</p> + </div> + </td> + </tr> + <tr> + <td><code>wrap</code></td> + <td>{{HTMLElement("textarea")}}</td> + <td>Cet attribut indique l'utilisation du retour automatique à la ligne pour le texte de l'élément.</td> + </tr> + </tbody> +</table> + +<h2 id="Attribut_de_contenu_ou_attribut_IDL">Attribut de contenu ou attribut IDL ?</h2> + +<p>En HTML, la plupart des attributs ont deux aspects : l'<strong>attribut de contenu</strong> et l'<strong>attribut IDL</strong> (pour <em>Interface Definition Language</em> ou langage de définition des interfaces).</p> + +<p>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 {{domxref("element.setAttribute()")}} et {{domxref("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 <code>maxlength</code> d'un élément {{HTMLElement("input")}} à 42, on utilisera <code>setAttribute("maxlength", "42")</code> sur cet élément.</p> + +<p>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 <code class="moz-txt-verticalline">élément.toto</code>. 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.</p> + +<p>La plupart du temps, les attributs IDL renverront leurs valeurs, telles qu'elles sont utilisées. Par exemple, le type (l'attribut <code>type</code>) par défaut des éléments {{HTMLElement("input")}} vaut <code>"text"</code>, et si on définit <code>input.type="tototruc"</code>, l'élément <code><input></code> se comportera comme un élément de type <code>text</code> (en termes d'apparence et de comportement) mais le contenu de l'attribut <code>type</code> sera "tototruc". Cependant, l'attribut de type IDL renverra la chaîne <code>"text"</code>.</p> + +<p>Les attributs IDL ne sont pas toujours des chaînes de caractères. <code>input.maxlength</code> 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, <code>input.maxlength</code> 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.</p> + +<p>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, <a href="https://www.w3.org/TR/2011/WD-html5-20110525/common-dom-interfaces.html#reflecting-content-attributes-in-idl-attributes">les règles de cette spécification seront suivies</a>.</p> + +<h2 id="Attributs_booléens">Attributs booléens</h2> + +<p>Certains attributs de contenu (ex. <code>required</code>, <code>readonly</code>, <code>disabled</code>) sont des <a href="https://www.w3.org/TR/html52/infrastructure.html#sec-boolean-attributes">attributs booléens</a>. Si un attribut booléen est présent, sa valeur correspondra à <em>vrai</em> (<em>true</em>), s'il est absent, sa valeur correspondra à <em>faux</em> (<em>false</em>).</p> + +<p>HTML5 définit certaines restrictions quant aux valeurs autorisées pour les attributs booléens. Si un attribut est présent, sa valeur doit être :</p> + +<ul> + <li>aucune valeur</li> + <li>la chaîne vide</li> + <li>une valeur écrite en ASCII, insensible à la casse, qui représente le nom canonique de l'attribut sans blanc avant ou après la valeur.</li> +</ul> + +<p>Voici quelques exemples valides pour utiliser un attribut booléen :</p> + +<pre><div itemscope>Ce fragment est du HTML valide mais du XML invalide.</div> +<div itemscope=itemscope>Ce fragment est du HTML valide mais du XML invalide.</div> +<div itemscope="">Ce fragment est du HTML valide et du XML valide.</div> +<div itemscope="itemscope">Ce fragment est du HTML et du XML valide mais est plus verbeux.</div></pre> + +<p>Pour être tout à fait explicite, les valeurs <code>"true"</code> et <code>"false"</code> ne sont pas autorisées pour les attributs booléens. Pour représenter une valeur fausse, il faudra ne pas écrire l'attribut du tout.</p> + +<p>Cette règle peut entraîner quelques incompréhensions : si on écrit <code>checked="false"</code> l'attribut <code>checked</code> sera présent et donc considéré comme <em>vrai</em> (<em>true</em>).</p> + +<h2 id="Voir_aussi">Voir aussi</h2> + +<ul> + <li><a href="/fr/docs/Web/HTML/Element">Les éléments HTML</a></li> +</ul> |