From 9e681a54e6f8c8c2f1a4c0385e337a93334a5355 Mon Sep 17 00:00:00 2001 From: "Queen Vinyl Da.i'gyu-Kazotetsu" Date: Wed, 26 Jul 2023 03:20:31 -0700 Subject: [PATCH] fr: Format /web/html using Prettier (part 3) --- .../fr/web/html/element/input/image/index.md | 32 ++- files/fr/web/html/element/input/index.md | 180 ++++++++++------ .../fr/web/html/element/input/month/index.md | 106 ++++++---- .../fr/web/html/element/input/number/index.md | 127 ++++++----- .../web/html/element/input/password/index.md | 46 ++-- .../fr/web/html/element/input/radio/index.md | 81 +++---- .../fr/web/html/element/input/range/index.md | 26 +-- .../fr/web/html/element/input/reset/index.md | 15 +- .../fr/web/html/element/input/search/index.md | 75 ++++--- .../fr/web/html/element/input/submit/index.md | 25 ++- files/fr/web/html/element/input/tel/index.md | 133 +++++++----- files/fr/web/html/element/input/text/index.md | 81 ++++--- files/fr/web/html/element/input/time/index.md | 170 +++++++++------ files/fr/web/html/element/input/url/index.md | 78 ++++--- files/fr/web/html/element/input/week/index.md | 80 +++---- files/fr/web/html/element/kbd/index.md | 37 ++-- files/fr/web/html/element/label/index.md | 13 +- files/fr/web/html/element/legend/index.md | 2 +- files/fr/web/html/element/link/index.md | 40 ++-- files/fr/web/html/element/main/index.md | 18 +- files/fr/web/html/element/map/index.md | 9 +- files/fr/web/html/element/mark/index.md | 20 +- files/fr/web/html/element/marquee/index.md | 13 +- files/fr/web/html/element/menu/index.md | 3 +- files/fr/web/html/element/menuitem/index.md | 14 +- files/fr/web/html/element/meta/index.md | 9 +- files/fr/web/html/element/meta/name/index.md | 31 +-- .../element/meta/name/theme-color/index.md | 9 +- files/fr/web/html/element/meter/index.md | 8 +- files/fr/web/html/element/noframes/index.md | 9 +- files/fr/web/html/element/object/index.md | 10 +- files/fr/web/html/element/ol/index.md | 19 +- files/fr/web/html/element/output/index.md | 6 +- files/fr/web/html/element/p/index.md | 9 +- files/fr/web/html/element/param/index.md | 2 +- files/fr/web/html/element/picture/index.md | 8 +- files/fr/web/html/element/pre/index.md | 4 +- files/fr/web/html/element/progress/index.md | 2 +- files/fr/web/html/element/q/index.md | 9 +- files/fr/web/html/element/rb/index.md | 10 +- files/fr/web/html/element/rp/index.md | 3 +- files/fr/web/html/element/rt/index.md | 5 +- files/fr/web/html/element/rtc/index.md | 6 +- files/fr/web/html/element/ruby/index.md | 7 +- files/fr/web/html/element/s/index.md | 4 +- files/fr/web/html/element/samp/index.md | 6 +- files/fr/web/html/element/select/index.md | 3 +- files/fr/web/html/element/slot/index.md | 30 ++- files/fr/web/html/element/small/index.md | 5 +- files/fr/web/html/element/source/index.md | 12 +- files/fr/web/html/element/strike/index.md | 5 +- files/fr/web/html/element/strong/index.md | 3 +- files/fr/web/html/element/style/index.md | 96 ++++----- files/fr/web/html/element/sub/index.md | 9 +- files/fr/web/html/element/summary/index.md | 3 +- files/fr/web/html/element/sup/index.md | 12 +- files/fr/web/html/element/table/index.md | 12 +- files/fr/web/html/element/tbody/index.md | 19 +- files/fr/web/html/element/td/index.md | 11 + files/fr/web/html/element/template/index.md | 2 - files/fr/web/html/element/textarea/index.md | 31 +-- files/fr/web/html/element/tfoot/index.md | 3 + files/fr/web/html/element/th/index.md | 13 ++ files/fr/web/html/element/thead/index.md | 5 + files/fr/web/html/element/time/index.md | 3 +- files/fr/web/html/element/title/index.md | 5 +- files/fr/web/html/element/tr/index.md | 42 ++-- files/fr/web/html/element/track/index.md | 28 ++- files/fr/web/html/element/tt/index.md | 3 +- files/fr/web/html/element/u/index.md | 2 +- files/fr/web/html/element/ul/index.md | 18 +- files/fr/web/html/element/var/index.md | 14 +- files/fr/web/html/element/video/index.md | 81 +++---- files/fr/web/html/element/wbr/index.md | 4 +- .../html/global_attributes/autofocus/index.md | 2 +- .../global_attributes/contextmenu/index.md | 63 ++++-- files/fr/web/html/global_attributes/index.md | 1 + .../html/global_attributes/itemid/index.md | 18 +- .../html/global_attributes/itemprop/index.md | 167 +++++++-------- .../html/global_attributes/itemref/index.md | 6 +- .../web/html/global_attributes/nonce/index.md | 12 +- .../web/html/global_attributes/style/index.md | 4 +- .../web/html/global_attributes/title/index.md | 12 +- .../html/global_attributes/translate/index.md | 4 +- files/fr/web/html/microdata/index.md | 18 +- files/fr/web/html/microformats/index.md | 198 ++++++++++++------ .../quirks_mode_and_standards_mode/index.md | 7 +- files/fr/web/html/viewport_meta_tag/index.md | 10 +- 88 files changed, 1533 insertions(+), 1063 deletions(-) diff --git a/files/fr/web/html/element/input/image/index.md b/files/fr/web/html/element/input/image/index.md index 39d2f94c8516db..8dd6e315970555 100644 --- a/files/fr/web/html/element/input/image/index.md +++ b/files/fr/web/html/element/input/image/index.md @@ -150,8 +150,13 @@ Un élément `` est [un élément remplacé](/fr/docs/Web/CS Prenons un exemple simple qui utilise les différentes fonctionnalités essentielles d'un tel bouton (et qui fonctionnent de la même façon que pour un élément ``) : ```html - + ``` {{EmbedLiveSample('', 600, 50)}} @@ -199,14 +204,19 @@ L'exemple suivant affiche le même bouton qu'auparavant, cette fois-ci inclus da

Connectez-vous à votre compte

- +
- +
- +
``` @@ -243,16 +253,20 @@ Dans ce nouvel exemple, on adapte l'exemple précédent afin d'avoir plus de pla

Connectez-vous à votre compte

- +
- +
- + alt="Login" + width="200" + height="100" />
``` diff --git a/files/fr/web/html/element/input/index.md b/files/fr/web/html/element/input/index.md index 2d3a413ec0ef56..90ac41a5283699 100644 --- a/files/fr/web/html/element/input/index.md +++ b/files/fr/web/html/element/input/index.md @@ -266,39 +266,39 @@ Sur cette page, vous trouverez des informations sur les attributs communs à l'e Les éléments `` peuvent utiliser les [attributs universels](/fr/docs/Web/HTML/Global_attributes) et les attributs suivants : -| Attribut | Type(s) | Description | -| ----------------------------------- | ------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------| -| [`accept`](#accept) | `file` | Une indication quant au type de fichier attendu pour l'upload | -| [`alt`](#alt) | `image` | Un texte alternatif à l'image, nécessaire pour une accessibilité correcte | -| [`autocomplete`](#autocomplete) | tous | Une indication pour le remplissage automatique du formulaire | -| [`capture`](#capture) | `file` | La méthode de capture du média pour l'upload du fichier | -| [`checked`](#checked) | `radio`, `checkbox` | Indique si l'option est sélectionnée ou si la case est cochée | -| [`dirname`](#dirname) | `text`, `search` | Le nom du champ de formulaire à utiliser pour envoyer le sens d'écriture de l'élément à l'envoi du formulaire | -| [`disabled`](#disabled) | tous | Indique si le contrôle est désactivé | -| [`form`](#form) | tous | Associe un contrôle à un élément de formulaire | -| [`formaction`](#formaction) | `image`, `submit` | L'URL à utiliser pour l'envoi du formulaire | -| [`formenctype`](#formenctype) | `image`, `submit` | L'encodage des données à utiliser pour l'envoi du formulaire | -| [`formmethod`](#formmethod) | `image`, `submit` | La méthode HTTP à utiliser pour envoyer le formulaire | -| [`formnovalidate`](#formnovalidate) | `image`, `submit` | Surcharge la validation du contrôle dictée par le formulaire pour l'envoi de ce dernier | -| [`formtarget`](#formtarget) | `image`, `submit` | Le contexte de navigation à utiliser pour l'envoi du formulaire | -| [`height`](#height) | `image` | Analogue à l'attribut `height` de l'élément [``](/fr/docs/Web/HTML/Element/Img), la hauteur de l'image | +| Attribut | Type(s) | Description | +| ----------------------------------- | ------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------- | +| [`accept`](#accept) | `file` | Une indication quant au type de fichier attendu pour l'upload | +| [`alt`](#alt) | `image` | Un texte alternatif à l'image, nécessaire pour une accessibilité correcte | +| [`autocomplete`](#autocomplete) | tous | Une indication pour le remplissage automatique du formulaire | +| [`capture`](#capture) | `file` | La méthode de capture du média pour l'upload du fichier | +| [`checked`](#checked) | `radio`, `checkbox` | Indique si l'option est sélectionnée ou si la case est cochée | +| [`dirname`](#dirname) | `text`, `search` | Le nom du champ de formulaire à utiliser pour envoyer le sens d'écriture de l'élément à l'envoi du formulaire | +| [`disabled`](#disabled) | tous | Indique si le contrôle est désactivé | +| [`form`](#form) | tous | Associe un contrôle à un élément de formulaire | +| [`formaction`](#formaction) | `image`, `submit` | L'URL à utiliser pour l'envoi du formulaire | +| [`formenctype`](#formenctype) | `image`, `submit` | L'encodage des données à utiliser pour l'envoi du formulaire | +| [`formmethod`](#formmethod) | `image`, `submit` | La méthode HTTP à utiliser pour envoyer le formulaire | +| [`formnovalidate`](#formnovalidate) | `image`, `submit` | Surcharge la validation du contrôle dictée par le formulaire pour l'envoi de ce dernier | +| [`formtarget`](#formtarget) | `image`, `submit` | Le contexte de navigation à utiliser pour l'envoi du formulaire | +| [`height`](#height) | `image` | Analogue à l'attribut `height` de l'élément [``](/fr/docs/Web/HTML/Element/Img), la hauteur de l'image | | [`list`](#list) | presque tous | La valeur de l'attribut `id` de l'élément [``](/fr/docs/Web/HTML/Element/datalist) fournissant les options d'autocomplétion | -| [`max`](#max) | types numériques | La valeur maximale | -| [`maxlength`](#maxlength) | `password`, `search`, `tel`, `text`, `url` | La longueur maximale (en nombre de caractères) de l'attribut `value` | -| [`min`](#min) | types numériques | La valeur minimale | -| [`minlength`](#minlength) | `password`, `search`, `tel`, `text`, `url` | La longueur minimale (en nombre de caractères) de l'attribut `value` | -| [`multiple`](#multiple) | `email`, `file` | Un booléen indiquant si plusieurs valeurs sont acceptées | -| [`name`](#name) | tous | Le nom associé au contrôle et qui est envoyé avec le formulaire associé à la valeur sous la forme d'une paire nom/valeur | -| [`pattern`](#pattern) | `password`, `text`, `tel` | Un motif que la valeur doit respecter afin d'être valide | -| [`placeholder`](#placeholder) | `password`, `search`, `tel`, `text`, `url` | Un texte qui apparaît dans le contrôle lorsqu'aucune valeur n'y est écrite | -| [`readonly`](#readonly) | presque tous | Un booléen indiquant que la valeur n'est pas éditable | -| [`required`](#required) | presque tous | Un booléen indiquant que la valeur est requise ou que le contrôle doit être coché avant de pouvoir envoyer le formulaire | -| [`size`](#size) | `email`, `password`, `tel`, `text`, `url` | La taille du contrôle | -| [`src`](#src) | `image` | Analogue à l'attribut `src` de l'élément [``](/fr/docs/Web/HTML/Element/Img), indique l'emplacement de l'image | -| [`step`](#step) | types numériques | Un incrément pour les valeurs valides | -| [`type`](#type) | tous | Le type de contrôle de formulaire | -| [`value`](#value) | tous | La valeur initiale du contrôle | -| [`width`](#width) | `image` | Analogue à l'attribut `width` de l'élément [``](/fr/docs/Web/HTML/Element/Img), la largeur de l'image | +| [`max`](#max) | types numériques | La valeur maximale | +| [`maxlength`](#maxlength) | `password`, `search`, `tel`, `text`, `url` | La longueur maximale (en nombre de caractères) de l'attribut `value` | +| [`min`](#min) | types numériques | La valeur minimale | +| [`minlength`](#minlength) | `password`, `search`, `tel`, `text`, `url` | La longueur minimale (en nombre de caractères) de l'attribut `value` | +| [`multiple`](#multiple) | `email`, `file` | Un booléen indiquant si plusieurs valeurs sont acceptées | +| [`name`](#name) | tous | Le nom associé au contrôle et qui est envoyé avec le formulaire associé à la valeur sous la forme d'une paire nom/valeur | +| [`pattern`](#pattern) | `password`, `text`, `tel` | Un motif que la valeur doit respecter afin d'être valide | +| [`placeholder`](#placeholder) | `password`, `search`, `tel`, `text`, `url` | Un texte qui apparaît dans le contrôle lorsqu'aucune valeur n'y est écrite | +| [`readonly`](#readonly) | presque tous | Un booléen indiquant que la valeur n'est pas éditable | +| [`required`](#required) | presque tous | Un booléen indiquant que la valeur est requise ou que le contrôle doit être coché avant de pouvoir envoyer le formulaire | +| [`size`](#size) | `email`, `password`, `tel`, `text`, `url` | La taille du contrôle | +| [`src`](#src) | `image` | Analogue à l'attribut `src` de l'élément [``](/fr/docs/Web/HTML/Element/Img), indique l'emplacement de l'image | +| [`step`](#step) | types numériques | Un incrément pour les valeurs valides | +| [`type`](#type) | tous | Le type de contrôle de formulaire | +| [`value`](#value) | tous | La valeur initiale du contrôle | +| [`width`](#width) | `image` | Analogue à l'attribut `width` de l'élément [``](/fr/docs/Web/HTML/Element/Img), la largeur de l'image | Certains attributs non-standard supplémentaires sont listés après les descriptions des attributs standard. @@ -311,7 +311,9 @@ Certains attributs non-standard supplémentaires sont listés après les descrip - [`autocomplete`](/fr/docs/Web/HTML/Attributes/autocomplete) - : **Cet attribut n'est pas booléen !** Il prend comme valeur une chaîne de caractères dont les valeurs sont séparées par des espaces qui décrivent, le cas échéant, le type de fonctionnalité à fournir pour l'autocomplétion du champ. Généralement, l'implémentation de l'autocomplétion repose sur les valeurs précédemment saisies dans le même champ, mais le navigateur peut implémenter une forme d'autocomplétion plus avancée (par exemple intégrer la liste des contacts connue de l'appareil pour autocompléter les champs `email`). Voir [la page sur cet attribut](/fr/docs/Web/HTML/Attributes/autocomplete#valeurs) pour les valeurs autorisées. Cet attribut est valide pour les types de champ `hidden`, `text`, `search`, `url`, `tel`, `email`, `date`, `month`, `week`, `time`, `datetime-local`, `number`, `range`, `color`, et `password`. Il n'a pas d'effet pour les types de champs qui ne renvoient pas de données numériques ou text et est donc valide pour tous les types de champs à l'exception de `checkbox`, `radio`, `file`, ou des types de bouton. Voir [la page de l'attribut HTML `autocomplete`](/fr/docs/Web/HTML/Attributes/autocomplete) pour plus d'informations, y compris sur la sécurité des mots de passe et sur la façon dont `autocomplete` s'applique légèrement différemment pour les champs de type `hidden`. - `autofocus` + - : Un attribut booléen qui, s'il est présent, indique que le contrôle devrait automatiquement recevoir le focus lorsque le chargement de la page est terminé (ou lorsque l'élément [``](/fr/docs/Web/HTML/Element/dialog) qui contient ce contrôle a été affiché). + > **Note :** Un élément avec l'attribut `autofocus` pourra recevoir le focus avant le déclenchement de l'évènement [`DOMContentLoaded`](/fr/docs/Web/API/Window/DOMContentLoaded_event). Il ne peut pas y avoir plus d'un élément du document avec l'attribut `autofocus`. Si l'attribut est placé sur plus d'un élément, c'est le premier qui reçoit le focus. @@ -321,38 +323,50 @@ Certains attributs non-standard supplémentaires sont listés après les descrip > **Attention :** Affecter le focus de façon automatique peut être source de confusion pour les personnes qui utilisent des lecteurs d'écran ou qui ont des difficultés cognitives. En effet, avec l'affectation d'`autofocus`, les lecteurs d'écran « téléportent » la personne jusqu'au contrôle, sans avertissement préalable. On fera particulièrement attention à l'accessibilité en appliquant l'attribut `autofocus`. Le focus automatique peut entraîner le défilement de la page au chargement et faire apparaître le clavier logiciel sur certains appareils tactiles. Bien qu'un lecteur d'écran puisse annoncer le libellé du contrôle qui reçoit le focus, il n'annoncera rien avant le libellé. De même, une personne sans déficience visuelle sur un petit écran manquera certainement le contexte créé par le contenu qui précède. + - `capture` - : Cet attribut, introduit avec la spécification HTML Media Capture, est uniquement valide pour le type `file`. Il définit quel appareil (micro, caméra, appareil photo) qui devrait être utilisé pour capturer un nouveau fichier à uploader. Voir la page détaillée sur [``](/fr/docs/Web/HTML/Element/Input/file). - `checked` + - : Cet attribut booléen est valide pour les types `radio` et `checkbox`. Lorsqu'il est présent sur un contrôle de type `radio`, il indique que ce bouton radio sera celui sélectionné parmi le groupe de boutons radio qui partagent le même nom. Lorsqu'il est présent sur un contrôle de type `checkbox`, il indique que la case est cochée par défaut au chargement de la page. Attention, il _n'indique pas_ que la case est actuellement cochée, si l'état de la case à cocher change, l'attribut ne reflète pas ce changement (seul l'attribut IDL [`HTMLInputElement.checked`](/fr/docs/Web/API/HTMLInputElement) est mis à jour). > **Note :** À la différence des autres contrôles de saisie, la valeur d'une case à cocher ou d'un bouton radio est uniquement incluse dans les données envoyées s'ils sont sélectionnés. Si c'est le cas, le nom et la valeur des contrôles sélectionnés sont envoyés. > > Ainsi, si une case à cocher dont l'attribut `name` vaut `fruit` et dont l'attribut `value` vaut `cerise`, si la case est cochée, les données envoyées avec le formulaire contiendront `fruit=cerise`. Si la case à cocher n'est pas active, elle ne fera pas partie des données envoyées. Pour les cases à cocher et les boutons radio, la valeur par défaut de l'attribut `value` est `on`. + - `dirname` + - : Cet attribut, uniquement valide pour les types `text` et `search`, permet d'envoyer également le sens d'écriture de la valeur dans le formulaire. Lorsqu'il est présent, le contrôle du formulaire enverra deux paires nom/valeur : la première composée de [`name`](#name) et [`value`](#value), et la seconde composée de la valeur de `dirname` comme nom et de `ltr` ou `rtl` comme valeur, indiquée par le navigateur. ```html
- - + +
``` Lorsque le formulaire précédent est envoyé, on aura l'envoi de deux paires de clé/valeur `name`/`value` d'une part avec `fruit=cerise` et `dirname`/sens d'écriture d'autre part avec `fruit.dir=ltr`. + - `disabled` + - : Un attribut booléen qui, lorsqu'il est présent, indique qu'il n'est pas possible d'interagir avec le champ. Les champs désactivés sont généralement affichés avec une couleur plus sombre ou une autre forme d'indication pour signifier que le champ n'est pas utilisable. Plus précisément, les champs désactivés ne reçoivent pas les évènements [`click`](/fr/docs/Web/API/Element/click_event) et ne sont pas envoyés avec le formulaire. > **Note :** Bien que cela ne soit pas nécessaire selon la spécification, par défaut, Firefox [fera persister l'état désactivé obtenu dynamiquement](https://stackoverflow.com/questions/5985839/bug-with-firefox-disabled-attribute-of-input-not-resetting-when-refreshing) pour un champ `` même après des rechargements de la page. C'est l'attribut [`autocomplete`](#autocomplete) qui contrôle cette fonctionnalité. + - `form` + - : Une chaîne de caractères qui indique l'élément [`
`](/fr/docs/Web/HTML/Element/Form) auquel le contrôle est associé (on parle de son **formulaire propriétaire**). La valeur de la chaîne de caractères, si elle est présente, doit correspondre à la valeur d'un identifiant (l'attribut [`id`](#id)) d'un élément `` du même document. Si cet attribut n'est pas défini, l'élément `` est associé au formulaire qui le contient le plus proche, s'il existe. L'attribut `form` permet ainsi de placer un champ n'importe où dans le document tout en l'associant à un formulaire du document situé autre part. > **Note :** Un champ peut uniquement être associé avec un seul formulaire. + - `formaction` - : Uniquement valide pour les types `image` et `submit`. Voir la page détaillée sur [``](/fr/docs/Web/HTML/Element/Input/submit). - `formenctype` @@ -370,6 +384,7 @@ Certains attributs non-standard supplémentaires sont listés après les descrip - `inputmode` - : Un attribut universel, valide pour tous les éléments, qui fournit une indication au navigateur quant au type de clavier virtuel à utiliser pour l'édition de l'élément ou de son contenu. Les valeurs possibles sont `none`, `text`, `tel`, `url`, `email`, `numeric`, `decimal`, et `search`. - `list` + - : La valeur fournie à l'attribut `list` doit être l'identifiant (l'attribut [`id`](/fr/docs/Web/HTML/Global_attributes/id)) d'un élément [``](/fr/docs/Web/HTML/Element/datalist) situé dans le même document. L'élément `` fournit alors une liste de valeurs prédéfinies qui peuvent être suggérées pour la saisie dans le champ. Toute valeur de cette liste qui n'est pas compatible avec l'attribut [`type`](#type) ne sera pas incluse dans les suggestions. Les valeurs ainsi fournies sont des suggestions et pas des contraintes, une personne pourra tout à fait choisir parmi cette liste ou fournir une valeur différente. Cet attribut est valide pour les champs de type `text`, `search`, `url`, `tel`, `email`, `date`, `month`, `week`, `time`, `datetime-local`, `number`, `range`, et `color`. @@ -379,27 +394,37 @@ Certains attributs non-standard supplémentaires sont listés après les descrip Selon le navigateur, on pourra avoir une palette de couleurs spécifiques en suggestion, des marques présentes sur la piste d'un curseur, voire un contrôle s'ouvrant comme un élément [``](/fr/docs/Web/HTML/Element/Input/file) et [``](/fr/docs/Web/HTML/Element/input/email). - `name` + - : Une chaîne de caractères qui fourni le nom associé au contrôle. Le nom est envoyé avec la valeur du contrôle lors de l'envoi du formulaire. Cet attribut n'est pas strictement obligatoire mais devrait être utilisé dans la grande majorité des cas. Si un champ n'a pas d'attribut `name` ou que celui-ci est vide, la valeur du champ n'est pas envoyée avec le formulaire (à l'instar des contrôles désactivés, des boutons radio ou cases décochés, et des boutons de réinitialisation). @@ -420,16 +445,18 @@ Certains attributs non-standard supplémentaires sont listés après les descrip Lorsqu'un élément `` possède un attribut `name`, ce nom devient une propriété de l'objet [`HTMLFormElement.elements`](/fr/docs/Web/API/HTMLFormElement/elements) associé au formulaire propriétaire. Ainsi, si on a un champ dont le nom est `invite` et un autre dont le nom est `taille-chat`, on pourra manipuler les données du formulaire en JavaScript comme suit : ```js - let form = document.querySelector('form'); + let form = document.querySelector("form"); let nomInvite = form.elements.invite; - let tailleChat = form.elements['taille-chat']; + let tailleChat = form.elements["taille-chat"]; ``` À l'exécution de ce code, `nomInvite` correspondra à l'objet [`HTMLInputElement`](/fr/docs/Web/API/HTMLInputElement) associé au champ `invite`, et de même l'objet `tailleChat` correspondra à l'objet du DOM associé au champ avec le nom `taille-chat`. > **Attention :** On évitera de donner aux éléments de formulaire un nom qui correspond à une propriété native du DOM. Cela surchargerait la propriété ou la méthode native pour pointer vers le champ correspondant. + - `pattern` + - : Cet attribut est une expression rationnelle que la valeur du champ doit respecter afin de [valider les contraintes](/fr/docs/Web/Guide/HTML/Constraint_validation). Cette valeur doit être une expression rationnelle JavaScript valide (voir [`RegExp`](/fr/docs/Web/JavaScript/Reference/Global_Objects/RegExp)) telle que documentée dans [le guide sur les expressions rationnelles](/fr/docs/Web/JavaScript/Guide/Regular_Expressions). Le marqueur `'u'` est implicitement appliqué à la compilation de l'expression et le motif est donc traité comme une séquence de codets Unicode et non ASCII. Il ne faut pas encadrer le motif de barres obliques. Si l'attribut `pattern` est présent mais sans valeur ou que celle-ci est valide, aucune expression rationnelle n'est appliquée et l'attribut est ignoré. Si la valeur de `pattern` est valide et que la valeur du champ ne respecte pas le motif, le champ échouera à [la validation des contraintes](/fr/docs/Web/Guide/HTML/Constraint_validation) et empêchera l'envoi du formulaire. @@ -437,23 +464,31 @@ Certains attributs non-standard supplémentaires sont listés après les descrip > **Note :** En utilisant l'attribut `pattern`, il faut également informer l'utilisatrice ou l'utilisateur quant au format attendu, en ajoutant un texte explicatif à proximité. On peut aussi inclure un attribut [`title`](#title) pour expliquer les contraintes à respecter : la plupart des navigateurs afficheront le titre sous la forme d'une bulle d'information. Attention, une explication visible est nécessaire pour une accessibilité correcte, la bulle d'information fournie par `title` n'est qu'une amélioration secondaire. Voir [la validation côté client](#validation_côté_client) pour plus d'information. + - `placeholder` + - : Cet attribut est une chaîne de caractères qui fournit une brève indication quant au type d'information attendu dans le champ. Sa valeur devrait être un mot ou une courte phrase qui indique le type de données attendu plutôt qu'une explication ou une consigne. Le texte de cet attribut _ne doit pas_ inclure de retour chariot ou de saut de ligne. Ainsi, si un champ est destiné à la saisie d'un prénom et que le libellé est « Prénom », une valeur appropriée pour cet attribut pourra être `"ex. Mustafa"`. > **Note :** Sur le plan sémantique, l'attribut `placeholder` n'est pas aussi utile que d'autres méthodes pour expliquer le formulaire. Il peut aussi causer certains problèmes inattendus avec le contenu. Voir [les libellés](#libellés) pour plus d'informations. + - `readonly` + - : Un attribut booléen qui, lorsqu'il est présent, indique qu'il ne devrait pas être possible d'éditer la valeur du champ. Cet attribut est pris en charge par les types de contrôle `text`, `search`, `url`, `tel`, `email`, `date`, `month`, `week`, `time`, `datetime-local`, `number`, et `password`. Voir [l'attribut HTML `readonly`](/fr/docs/Web/HTML/Attributes/readonly) pour plus d'informations. + - `required` + - : Un attribut booléen qui, lorsqu'il est présent, indique qu'une valeur doit être saisie avant que le formulaire puisse être envoyé. Cet attribut est pris en charge pour les types de contrôle `text`, `search`, `url`, `tel`, `email`, `date`, `month`, `week`, `time`, `datetime-local`, `number`, `password`, `checkbox`, `radio`, et `file`. Voir [la validation côté client](#validation_côté_client) et [l'attribut HTML `required`](/fr/docs/Web/HTML/Attributes/required) pour plus d'informations. + - `size` - : Cet attribut est uniquement valide pour les types de contrôle `email`, `password`, `tel`, `url` et `text`. Il indique la largeur visible pour le contrôle. D'une certaine façon, il crée un résultat analogue à l'application de la propriété CSS `width`. L'unité de cette valeur dépend du type de contrôle. Pour les champs de type `password` et `text`, il s'agit du nombre de caractères (équivalent à l'unité `em`) et la valeur par défaut vaut `20`. Pour les autres types de champs, la valeur est exprimée en pixels. La largeur définie avec la feuille de style CSS aura la priorité sur cet attribut. - `src` - : Cet attribut est uniquement valide pour le type `image` et indique l'URL du fichier de l'image à afficher sur le bouton. Voir [``](/fr/docs/Web/HTML/Element/input/image) pour plus d'informations. - `step` + - : Cet attribut est valide pour les contrôles de type numérique (`number`, dates/heures, `range`). L'attribut [`step`](/fr/docs/Web/HTML/Attributes/step) est un nombre qui définit la granularité de la valeur. S'il n'est pas explicitement inclus : @@ -470,14 +505,17 @@ Certains attributs non-standard supplémentaires sont listés après les descrip > **Note :** Lorsque la donnée saisie ne respecte pas l'incrément, la valeur est considérée comme invalide pour la validation des contraintes et l'élément sera ciblé par la pseudo-classe `:invalid`. Voir [la validation côté client](#validation_côté_client) pour plus d'information. + - `tabindex` - : Un attribut universel, valide pour tous les éléments, y compris tous les types de ``. Sa valeur est un entier qui indique si l'élément peut prendre le focus et s'il devrait participer à la navigation séquentielle au clavier. Comme tous les types d'élément ``, sauf ceux masqués, peuvent prendre le focus, cet attribut ne devrait pas être utilisé sur les contrôles de formulaire, car cela nécessiterait de gérer l'ordre du focus pour tous les éléments du document, au risque de dégradé l'utilisabilité et l'accessibilité si cela était fait de façon incorrecte. - `title` - : Un attribut universel, valide pour tous les éléments, y compris tous les types de ``. Sa valeur est un texte fournissant des informations à propos de l'élément auquel il appartient. Une telle information est généralement (mais pas nécessairement) affichée sous la forme d'une bulle d'information. `title` ne devrait pas être utilisé comme méthode principale pour expliquer le rôle d'un contrôle de formulaire. Il faut plutôt utiliser l'élément [`