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

CKTIS / HTML

size — taille d’un champ input ou d’une liste select

L’attribut size définit la largeur visible d’un champ de texte en caractères ou le nombre d’options visibles d’une liste select. Il ne limite ni la longueur de la valeur ni n’active la sélection multiple.

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

Syntaxe

<input type="text" size="20">
<select size="3">...</select>

size n’est pas un attribut global. Lorsqu’il est présent sur input ou select, sa valeur valide est un entier positif sans unité ; 0, les nombres négatifs et 20px sont des valeurs non valides.

Sur input, il s’applique aux types text, search, tel, url, email et password, mais pas à number. Il indique le nombre de caractères pour lesquels le navigateur doit prévoir un espace visible pendant la modification, et non une largeur exacte en pixels. La propriété DOM input.size vaut 20 par défaut. size ne limite pas la longueur de la valeur ; utilisez maxlength pour cela.

Sur select, il indique combien d’options afficher. size="2" seul n’active pas la sélection multiple : l’attribut multiple est nécessaire. Si l’attribut est absent ou si l’analyse de l’entier échoue, la taille d’affichage est 4 avec multiple, et 1 dans le cas contraire. Ne confondez pas cette taille d’affichage avec la valeur par défaut de la propriété DOM select.size.

L’exemple distingue la taille de la valeur et du nombre d’options sélectionnées : le champ a size="4", mais contient sept caractères, et la liste a size="2" tandis que multiple reste à false.

Exemples

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>size example</title>
<label>Code <input id="code" type="text" size="4" value="ABCDEFG"></label>
<label>Item
  <select id="item" size="2">
    <option>A</option>
    <option>B</option>
    <option>C</option>
  </select>
</label>
<pre id="result"></pre>
<script>
  const code = document.getElementById('code');
  const item = document.getElementById('item');
  document.getElementById('result').textContent =
    `input.size=${code.size}\ninput.value.length=${code.value.length}\nselect.size=${item.size}\nselect.multiple=${item.multiple}`;
</script>
</html>

Résultat

input.size=4
input.value.length=7
select.size=2
select.multiple=false

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