Атрибут HTML: min

Атрибут min определяет минимальное допустимое значение для ввода, содержащего этот атрибут. Если значение value элемента меньше этого значения, элемент не проходит валидацию. Это значение должно быть меньше или равно значению атрибута max.

У некоторых типов ввода есть значение по умолчанию. Если у ввода нет минимального значения по умолчанию и для min задано значение, которое нельзя преобразовать в действительное число (или минимальное значение не задано), то минимальное значение для ввода не определено.

Данный атрибут допустим для типов ввода: дата, месяц, неделя, время, дата и время, число и диапазон, а также для элемента <meter>.

Синтаксис

Синтаксис значений `min` для ввода `type`
Тип ввода	Синтаксис	Пример
дата	`yyyy-mm-dd`	`<input type="date" min="2019-12-25" step="1">`
месяц	`yyyy-mm`	`<input type="month" min="2019-12" step="12">`
неделя	`yyyy-W##`	`<input type="week" min="2019-W23" step="">`
время	`hh:mm`	`<input type="time" min="09:00" step="900">`
дата и время	`yyyy-mm-ddThh:mm`	`<input type="datetime-local" min="2019-12-25T19:30">`
число	<число>	`<input type="number" min="0" step="5" max="100">`
диапазон	<число>	`<input type="range" min="60" step="5" max="100">`

Примечание: Если введённые пользователем данные не соответствуют заданному минимальному значению, значение считается недопустимым при проверке ограничений и будет соответствовать псевдоклассам :invalid и :out-of-range.

См. Проверка ограничений на стороне клиента и rangeUnderflow для получения дополнительной информации.

Для элемента <meter> атрибут min определяет нижнюю числовую границу измеряемого диапазона. Она должна быть меньше максимального значения (атрибут max), если задано. В обоих случаях, если атрибут опущен, значение по умолчанию равно 1.

Синтаксис значений `min` для других элементов
Тип ввода	Синтаксис	Пример
`<meter>`	<число>	`<meter id="fuel" min="0" max="100" low="33" high="66" optimum="80" value="40"> at 40/100</meter>`

Влияние на шаг

Значения min и step определяют допустимые значения, даже если атрибут step не указан, так как step по умолчанию равно 0.

Добавим красную границу вокруг неверного ввода:

css

input:invalid {
  border: solid red 3px;
}

Затем определим поле ввода с минимальным значением 7,2, опуская атрибут шага, при котором он по умолчанию равен 1.

html

<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

Совместимость с браузерами

	Рабочие столы					Мобильные устройства
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox for Android	Opera Android	Safari на iOS	Samsung Internet	WebView Android
`min`	6	≤18	16	11	6	18	16	11	10.3	1.0	Нет

	Рабочие столы					Мобильные устройства
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox for Android	Opera Android	Safari на iOS	Samsung Internet	WebView Android
`min`	4	12	16	≤12.1	5	18	16	≤12.1	4	1.0	≤37

html.elements.input.min

Таблицы BCD загружаются только в браузере

html.elements.meter.min

Таблицы BCD загружаются только в браузере

См. также

step
max
Другие атрибуты meter: low, high, optimum
Проверка ограничений
Валидация форм
validityState.rangeUnderflow
:out-of-range
<input>
дата, месяц, неделя, время, дата и время, число и диапазон, а также <meter>

© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/min