Атрибут HTML – min

Атрибут min (мінімум) визначає мінімальне значення, що є прийнятним і дійсним для поля, що містить цей атрибут. Якщо value елемента не досягає значення min, то елемент провалює валідацію. Це значення повинно бути меншим або рівним значенню атрибута max.

Частина типів полів мають усталений мінімум. Якщо поле не має усталеного мінімуму і для min задано значення, що не може бути перетворено на дійсне число (або мінімальне значення не задано), то поле не має мінімального значення.

Цей атрибут прийнятний для типів полів, серед яких date, month, week, time, datetime-local, number and range, а також елемент <meter>.

Синтаксис

Примітка: Коли дані, введені користувачем, не відповідають заданому мінімальному значенню, то значення поля вважається неприйнятним при валідації обмежень і дає збіг з псевдокласами :invalid і :out-of-range.

Дивіться докладніше у Валідації на клієнтському боці та rangeUnderflow.

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

Вплив на step

Значення 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 переконайтеся, що такий мінімум зрозумілий користувачам. Достатньо може бути додавання інструкцій в підписах. Якщо інструкції надаються поза підписами, що дає змогу застосовувати до них гнучкіші позиціювання та дизайн, розгляньте варіант використання aria-labelledby або aria-describedby.

Специфікації

Сумісність із браузерами

Дивіться також

• step
• max
• інші атрибути лічильників: low, high, optimum
• Валідація обмежень
• Валідація форм
• validityState.rangeUnderflow
• :out-of-range
• <input>
• Типи date, month, week, time, datetime-local, number, range, а також <meter>