Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / HTML

placeholder — un indice dans un champ vide

L’attribut placeholder fournit un court indice pour un champ input ou textarea vide. Il ne définit pas la valeur du champ et ne doit pas remplacer son libellé.

Version : WHATWG HTML Living Standard; index snapshot date recorded separately

Syntaxe

<input type="text" placeholder="hint">
<textarea placeholder="hint"></textarea>

placeholder contient un court indice, par exemple une valeur d’exemple ou le format attendu. Il s’applique à textarea et aux types input suivants : text, search, url, tel, email, password et number ; ce n’est pas un attribut global.

L’indice est destiné à un champ vide. Dès qu’une valeur est saisie, il n’est plus affiché ; sa visibilité lorsque le champ est actif peut dépendre du navigateur. Ne l’utilisez pas à la place de label : le libellé doit identifier le champ même lorsque la saisie a commencé.

Le texte placeholder n’est ni la valeur du champ ni sa valeur par défaut, et ne satisfait pas à lui seul la condition required. Pour input, la valeur de l’attribut ne doit contenir aucun caractère LF ou CR. Dans textarea, les caractères CRLF, CR et LF de l’indice sont affichés sous forme de retours à la ligne.

Exemples

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>Placeholder example</title>
<label for="city">City</label>
<input id="city" type="text" placeholder="Krakow">
<p id="result"></p>
<script>
  const city = document.getElementById('city');
  document.getElementById('result').textContent =
    JSON.stringify({ value: city.value, hint: city.placeholder });
</script>
</html>

Résultat

{"value":"","hint":"Krakow"}

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources