aboutsummaryrefslogtreecommitdiff
path: root/files/fr/web/html/attributes/min/index.md
blob: 9a142deaeb1da5aa769550bf292b98822650f97d (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
---
title: 'Attribut HTML : min'
slug: Web/HTML/Attributes/min
tags:
  - Attribute
  - Attributes
  - Constraint validation
  - HTML
  - min
  - Reference
translation_of: Web/HTML/Attributes/min
---
<p>{{HTMLSidebar}}</p>

<p>L'attribut <strong><code>min</code></strong> définit la valeur minimale qui est acceptable et valide pour l'entrée contenant l'attribut. Si la <a href="/fr/docs/Web/HTML/Element/Input#attr-value">valeur</a> de l'élément est inférieure à cette valeur, l'élément échoue lors de la <a href="/fr/docs/Web/Guide/HTML/HTML5/Constraint_validation">validation des contraintes</a>. Cette valeur doit être inférieure ou égale à la valeur de l'attribut <code>max</code>. Si une valeur est spécifiée pour <code>min</code> qui n'est pas un nombre valide, l'entrée n'a pas de valeur minimale.</p>

<p>Valable pour les types de saisie numérique, y compris les types <a href="/fr/docs/Web/HTML/Element/Input/date"><code>date</code></a>, <a href="/fr/docs/Web/HTML/Element/Input/month"><code>month</code></a>, <a href="/fr/docs/Web/HTML/Element/Input/week"><code>week</code></a>, <a href="/fr/docs/Web/HTML/Element/Input/time"><code>time</code></a>, <a href="/fr/docs/Web/HTML/Element/Input/datetime-local"><code>datetime-local</code></a>, <a href="/fr/docs/Web/HTML/Element/Input/number"><code>number</code></a> et <a href="/fr/docs/Web/HTML/Element/Input/range"><code>range</code></a>, et l'élément <a href="/fr/docs/Web/HTML/Element/Meter"><code>&lt;meter&gt;</code></a>, l'attribut <code>min</code> est un nombre qui spécifie la valeur la plus négative qu'un contrôle de formulaire doit considérer comme valide.</p>

<h2 id="syntax">Syntaxe</h3>

<table class="standard-table">
  <caption>Syntaxe pour les valeurs <code>min</code> par <code>type</code> de saisie.</caption>
  <thead>
    <tr>
      <th scope="col">Type de saisie</th>
      <th scope="col">Syntaxe</th>
      <th scope="col">Exemple</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td><a href="/fr/docs/Web/HTML/Element/Input/date"><code>date</code></a></td>
      <td><pre class="brush: html">yyyy-mm-dd</pre></td>
      <td><pre class="brush: html">&lt;input type="date" min="2019-12-25" step="1"&gt;</pre></td>
    </tr>
    <tr>
      <td><a href="/fr/docs/Web/HTML/Element/Input/month"><code>month</code></a></td>
      <td><pre class="brush: html">yyyy-mm</pre></td>
      <td><pre class="brush: html">&lt;input type="month" min="2019-12" step="12"&gt;</pre></td>
    </tr>
    <tr>
      <td><a href="/fr/docs/Web/HTML/Element/Input/week"><code>week</code></a></td>
      <td><pre class="brush: html">yyyy-W##</pre></td>
      <td><pre class="brush: html">&lt;input type="week" min="2019-W23" step=""&gt;</pre></td>
    </tr>
    <tr>
      <td><a href="/fr/docs/Web/HTML/Element/Input/time"><code>time</code></a></td>
      <td><pre class="brush: html">hh:mm</pre></td>
      <td><pre class="brush: html">&lt;input type="time" min="09:00" step="900"&gt;</pre></td>
    </tr>
    <tr>
      <td><a href="/fr/docs/Web/HTML/Element/Input/datetime-local"><code>datetime-local</code></a></td>
      <td><code>yyyy-mm-ddThh:mm</code></td>
      <td><pre class="brush: html">&lt;input type="datetime-local" min="2019-12-25T19:30"&gt;</pre></td>
    </tr>
    <tr>
      <td><a href="/fr/docs/Web/HTML/Element/Input/number"><code>number</code></a></td>
      <td><a href="/fr/docs/Web/CSS/number">&lt;number&gt;</a></td>
      <td><pre class="brush: html">&lt;input type="number" min="0" step="5" max="100"&gt;</pre></td>
    </tr>
    <tr>
      <td><a href="/fr/docs/Web/HTML/Element/Input/range"><code>range</code></a></td>
      <td><a href="/fr/docs/Web/CSS/number">&lt;number&gt;</a></td>
      <td><pre class="brush: html">&lt;input type="range" min="60" step="5" max="100"&gt;</pre></td>
    </tr>
  </tbody>
</table>

<div class="note">
  <p><strong>Note :</strong>Lorsque les données saisies par l'utilisateur ne respectent pas la valeur minimale définie, la valeur est considérée comme non valide dans la validation des contraintes et correspondra aux pseudo-classes <a href="/fr/docs/Web/CSS/:invalid"><code>:invalid</code></a> et <a href="/fr/docs/Web/CSS/:out-of-range"><code>:out-of-range</code></a>.</p>
</div>

<p>Voir la <a href="/fr/docs/Web/Guide/HTML/HTML5/Constraint_validation">validation côté client</a> et <a href="/fr/docs/Web/API/ValidityState/rangeUnderflow"><code>rangeUnderflow</code></a> pour plus d'informations.</p>

<p>Pour l'élément <a href="/fr/docs/Web/HTML/Element/Meter"><code>&lt;meter&gt;</code></a>, l'attribut <code>min</code> définit la limite numérique inférieure de la plage mesurée. Celle-ci doit être inférieure à la valeur minimale (attribut <a href="/fr/docs/Web/HTML/Attributes/max"><code>max</code></a>), si elle est spécifiée. Dans les deux cas, si elle est omise, la valeur est égale à 1 par défaut.</p>

<table class="standard-table">
  <caption>Syntaxe de <code>min</code> pour les autres éléments</caption>
  <thead>
    <tr>
      <th scope="col">Élément</th>
      <th scope="col">Syntaxe</th>
      <th scope="col">Exemple</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td><a href="/fr/docs/Web/HTML/Element/Meter"><code>&lt;meter&gt;</code></a></td>
      <td><a href="/fr/docs/Web/CSS/number">&lt;number&gt;</a></td>
      <td><code>&lt;meter id="fuel" min="0" max="100" low="33" high="66" optimum="80" value="40"&gt; at 40/100&lt;/meter&gt;</code></td>
    </tr>
  </tbody>
</table>

<h3 id="impact_on_step">Impact sur <code>step</code></h3>

<p>Les valeurs de <code>min</code> et <code>step</code> définissent ce que sont les valeurs valides, même si l'attribut <code>step</code> n'est pas inclus, car <code>step</code> a par défaut la valeur <code>0</code>.</p>

<p>Nous ajoutons une grande bordure rouge autour des entrées invalides :</p>

<pre class="brush: css">input:invalid {
  border: solid red 3px;
}</pre>

<p>Nous définissons ensuite une entrée avec une valeur minimale de 7,2, en omettant l'attribut « step », qui a la valeur 1 par défaut.</p>

<pre class="brush: html">&lt;input id="myNumber" name="myNumber" type="number" min="7.2" value="8"&gt;</pre>

<p>Comme <code>step</code> a pour valeur 1 par défaut, les valeurs valides comprennent <code>7,2</code>, <code>8,2</code>, <code>9,2</code>, et ainsi de suite. La valeur 8 n'est pas valide. Comme nous avons inclus une valeur non valide, les navigateurs compatibles afficheront la valeur comme non valide.</p>

<div>{{EmbedLiveSample("impact_on_step", "", 55)}}</div>

<p>S'il n'est pas explicitement inclus, <code>step</code> prend par défaut la valeur 1 pour <code>number</code> et <code>range</code>, et 1 type d'unité (seconde, semaine, mois, jour) pour les types d'entrée date/heure.</p>

<h2 id="accessibility_concerns">Accessibilité</h2>

<p>Fournissez des instructions pour aider les utilisateurs à comprendre comment remplir le formulaire et utiliser les contrôles individuels du formulaire. Indiquez toute entrée obligatoire et facultative, les formats de données et toute autre information pertinente. Lorsque vous utilisez l'attribut <code>min</code>, assurez-vous que cette exigence minimale est comprise par l'utilisateur. Fournir des instructions à l'intérieur des <a href="/fr/docs/Web/HTML/Element/label"><code>&lt;label&gt;</code></a> peut être suffisant. Si vous fournissez des instructions en dehors des étiquettes, ce qui permet un positionnement et une conception plus souples, envisagez d'utiliser <a href="/fr/docs/Web/Accessibility/ARIA/ARIA_Techniques/Using_the_aria-labelledby_attribute"><code>aria-labelledby</code></a> ou <a href="/fr/docs/Web/Accessibility/ARIA/ARIA_Techniques/Using_the_aria-describedby_attribute"><code>aria-describedby</code></a>.</p>

<h2 id="specifications">Spécifications</h2>

<table class="standard-table">
  <thead>
    <tr>
      <th scope="col">Spécification</th>
      <th scope="col">Statut</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td>{{SpecName('HTML WHATWG', 'input.html#the-min-and-max-attributes', 'min attribute')}}</td>
      <td>{{Spec2('HTML WHATWG')}}</td>
    </tr>
    <tr>
      <td>{{SpecName('HTML5 W3C', 'input.html#the-min-and-max-attributes', 'min attribute')}}</td>
      <td>{{Spec2('HTML5 W3C')}}</td>
    </tr>
  </tbody>
</table>

<h2 id="browser_compatibility">Compatibilité des navigateurs</h2>

<p>{{Compat("html.elements.attributes.min")}}</p>

<h2 id="see_also">Voir aussi</h2>

<ul>
  <li>L'attribut <a href="/fr/docs/Web/HTML/Attributes/step"><code>step</code></a></li>
  <li>L'attribut <a href="/fr/docs/Web/HTML/Attributes/max"><code>max</code></a></li>
  <li>Les autres attributs de mesure : <a href="/fr/docs/Web/HTML/Element/meter#attr-low"><code>low</code></a>, <a href="/fr/docs/Web/HTML/Element/meter#attr-high"><code>high</code></a>, <a href="/fr/docs/Web/HTML/Element/meter#attr-optimum"><code>optimum</code></a></li>
  <li><a href="/fr/docs/Web/Guide/HTML/HTML5/Constraint_validation">Validation des contraintes</a></li>
  <li>L'API <a href="/fr/docs/Web/API/Constraint_validation">Constraint validation</a></li>
  <li>L'attribut JavaScript <a href="/fr/docs/Web/API/validityState/rangeUnderflow"><code>validityState.rangeUnderflow</code></a></li>
  <li>La pseudo-classe <a href="/fr/docs/Web/CSS/:out-of-range"><code>:out-of-range</code></a></li>
  <li>L'élément <a href="/fr/docs/Web/HTML/Element/input"><code>&lt;input&gt;</code></a></li>
  <li>Les valeurs de l'attribut type <a href="/fr/docs/Web/HTML/Element/input/date"><code>date</code></a>, <a href="/fr/docs/Web/HTML/Element/input/month"><code>month</code></a>, <a href="/fr/docs/Web/HTML/Element/input/week"><code>week</code></a>, <a href="/fr/docs/Web/HTML/Element/input/time"><code>time</code></a>, <a href="/fr/docs/Web/HTML/Element/input/datetime-local"><code>datetime-local</code></a>, <a href="/fr/docs/Web/HTML/Element/input/number"><code>number</code></a> et <a href="/fr/docs/Web/HTML/Element/input/range"><code>range</code></a>, et l'élément <a href="/fr/docs/Web/HTML/Element/meter"><code>&lt;meter&gt;</code></a></li>
</ul>