CKTIS / JavaScript
HTMLInputElement.max и disabled: горна граница и деактивиране на поле
`max` отразява горната граница като низ, а `disabled` показва дали самото поле има атрибут за деактивиране. Превишаването на границата не деактивира полето.
Версия: ECMAScript 2024 and the current web platform; runtime support varies
Синтаксис
input.max; // string: the max attribute, or "" if absent
input.max = "10"; // set the max attribute
input.removeAttribute("max");
input.disabled; // boolean: whether the input's own disabled attribute is present
input.disabled = true; // add the disabled attribute
input.disabled = false; // remove the disabled attribute
input.matches(":disabled"); // test whether the input is effectively disabledinput.max е свойство от тип низ, което може да се променя и отразява HTML атрибута max. То връща текста на атрибута или "", ако атрибутът липсва, а не изчислената горна граница. input.max = "10" задава атрибута, а input.removeAttribute("max") го премахва.
max се прилага за типовете number, range, date, month, week, time и datetime-local; форматът зависи от типа. Той не ограничава дължината на текста. Ако атрибутът липсва или не може да бъде разчетен, се използва горната граница по подразбиране за типа, ако има такава: за range тя е 100, а за number няма такава. В поле number число над границата остава във value и validity.rangeOverflow === true. Плъзгачът range вместо това коригира стойността според диапазона. При time диапазон с min, по-голямо от max, може да преминава през полунощ.
Булевото свойство input.disabled може да се променя и отразява наличието на атрибута disabled върху самото поле. true добавя атрибута, а false го премахва. Дори disabled="false" деактивира полето. Деактивиран fieldset деактивира и вложените полета, освен тези в първия му пряк дъщерен елемент legend. Затова input.disabled може да е false, дори когато input.matches(":disabled") връща true.
Потребителят не може да фокусира или редактира деактивирано поле, но JavaScript все още може да промени стойността му. Полето не участва в проверката на ограниченията (willValidate е false) и се пропуска при изпращане на формуляра и при създаване на new FormData(form). Тези свойства са част от DOM на браузъра, а не от ECMAScript; среда без DOM не ги предоставя. Винаги проверявай получените данни на сървъра независимо от настройките на полето.
Примери
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Input max and disabled</title>
</head>
<body>
<script>
const form = document.createElement('form');
const input = document.createElement('input');
input.type = 'number';
input.name = 'quantity';
input.max = '10';
input.value = '12';
form.append(input);
console.log(JSON.stringify([
input.max, input.value, input.validity.rangeOverflow,
input.checkValidity(), new FormData(form).has('quantity'),
]));
input.disabled = true;
console.log(JSON.stringify([
input.disabled, input.value, input.willValidate,
new FormData(form).has('quantity'),
]));
</script>
</body>
</html>Резултат
["10","12",true,false,true] [true,"12",false,false]
Запази примера като файл с разширение `.html`, отвори го в браузър и провери резултата в конзолата на браузъра. `"12"` превишава `"10"` и не преминава проверката, но `FormData` все пак включва стойността. След деактивиране полето запазва стойността си, но се пропуска при проверката и в данните на формуляра.
Свързани уроци
- JavaScript · Урок 28 · Средно · Версия: 3
Източници
- HTMLInputElement: max property
- HTMLInputElement: disabled property
- HTML Standard — The min and max attributes
- HTML Standard — Range state (type=range)
- HTML Standard — Enabling and disabling form controls: the disabled attribute
- HTML Standard — Constructing the entry list
- Using HTML form validation and the Constraint Validation API