min HTML-атрибут
Атрибут min определяет минимальное значение, допустимое и корректное для поля ввода, содержащего этот атрибут. Если value элемента меньше этого значения, элемент не проходит проверку корректности. Это значение должно быть меньше или равно значению атрибута max.
Для некоторых типов полей ввода задано минимальное значение по умолчанию. Если для поля ввода не задано минимальное значение по умолчанию и указано значение min, которое нельзя преобразовать в допустимое число (или минимальное значение не задано), поле ввода не имеет минимального значения.
Атрибут допустим для типов полей ввода: date, month, week, time, datetime-local, number и range, а также для элемента <meter>.
Синтаксис
| Тип поля ввода | Синтаксис | Пример |
|---|---|---|
| date | yyyy-mm-dd | <input type="date" min="2019-12-25" step="1"> |
| month | yyyy-mm | <input type="month" min="2019-12" step="12"> |
| week | yyyy-W## | <input type="week" min="2019-W23" step=""> |
| time | HH:mm | <input type="time" min="09:00" step="900"> |
| datetime-local | yyyy-mm-ddTHH:mm | <input type="datetime-local" min="2019-12-25T19:30"> |
| number | <number> | <input type="number" min="0" step="5" max="100"> |
| range | <number> | <input type="range" min="60" step="5" max="100"> |
Примечание: Если введённые пользователем данные не соответствуют заданному минимальному значению, значение считается недопустимым при проверке ограничений и соответствует псевдоклассам :invalid и :out-of-range.
Дополнительные сведения см. в разделах Проверка корректности на стороне клиента и rangeUnderflow.
Для элемента <meter> атрибут min задаёт нижнюю числовую границу измеряемого диапазона. Если указано максимальное значение (атрибут max), это значение должно быть меньше него. В обоих случаях, если значение не указано, по умолчанию используется 1.
Влияние на шаг
Значения min и step определяют допустимые значения, даже если атрибут step не указан, поскольку по умолчанию для step используется 0.
Мы добавим большую красную рамку вокруг недопустимых полей ввода:
input:invalid {
border: solid red 3px;
}
Затем зададим поле ввода с минимальным значением 7.2, не указывая атрибут step, поэтому для него будет использоваться значение по умолчанию — 1.
<input id="myNumber" name="myNumber" type="number" min="7.2" value="8" />
Поскольку для step по умолчанию используется значение 1, допустимыми значениями будут 7.2, 8.2, 9.2 и так далее. Значение 8 недопустимо. Поскольку мы указали недопустимое значение, браузеры с соответствующей поддержкой покажут его как недопустимое.
Если явно не указано иное, для step по умолчанию используется значение 1 для number и range, а для полей ввода даты и времени — 1 единица измерения (секунда, неделя, месяц, день).
Особенности доступности
Предоставьте инструкции, которые помогут пользователям понять, как заполнить форму и использовать отдельные элементы управления. Укажите, какие поля обязательны, а какие необязательны, форматы данных и другую важную информацию. При использовании атрибута min убедитесь, что пользователю понятно это минимальное требование. Для этого может быть достаточно добавить инструкции в <label>. Если инструкции размещаются за пределами меток, что позволяет гибче выбирать их положение и оформление, рассмотрите возможность использования aria-labelledby или aria-describedby.
Спецификации
| Спецификация |
|---|
| HTML> # attr-input-min> |
| HTML> # attr-meter-max> |
Совместимость с браузерами
>html.elements.input.min
| Настольные компьютеры | Мобильные устройства | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Opera | Safari | Chrome для Android | Firefox для Android | Opera для Android | Safari в iOS | Samsung Internet | WebView для Android | WebView для iOS | |
min |
4 | 12 | 16 | ≤12.1 | 5 | 18 | 16 | ≤12.1 | 4 | 1.0 | 4.4 | 4 |
html.elements.meter.min
| Настольные компьютеры | Мобильные устройства | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Opera | Safari | Chrome для Android | Firefox для Android | Opera для Android | Safari в iOS | Samsung Internet | WebView для Android | WebView для iOS | |
min |
6 | 13 | 16 | 11 | 6 | 18 | 16 | 11 | 10.3 | 1.0 | Нет | 10.3 |
См. также
stepmax- другие атрибуты meter:
low,high,optimum - Проверка ограничений
- Проверка корректности формы
validityState.rangeUnderflow:out-of-range<input>-
типы date, month, week, time, datetime-local, number и range, а также элемент
<meter>
© 2005–2025 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Attributes/min