CKTIS / JavaScript
HTMLInputElement.max a disabled: horná hranica a deaktivácia poľa
`max` odráža hornú hranicu ako reťazec a `disabled` vyjadruje, či má pole vlastný atribút na deaktiváciu. Prekročenie hranice pole nedeaktivuje.
Verzia: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
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 je zapisovateľná reťazcová vlastnosť, ktorá odráža atribút HTML max. Vracia text atribútu alebo "", ak atribút chýba, nie vypočítanú hornú hranicu. input.max = "10" nastaví atribút a input.removeAttribute("max") ho odstráni.
max sa vzťahuje na typy number, range, date, month, week, time a datetime-local; formát závisí od typu. Neobmedzuje dĺžku textu. Ak atribút chýba alebo ho nemožno interpretovať, použije sa predvolená horná hranica typu, ak existuje: pre range je to 100, pre number taká hranica neexistuje. V poli number ostáva číslo nad hranicou vo value a platí validity.rangeOverflow === true. Posuvník range naopak upraví hodnotu podľa rozsahu. Rozsah time s min väčším než max môže prechádzať cez polnoc.
Zapisovateľná booleovská vlastnosť input.disabled odráža prítomnosť atribútu disabled priamo na poli. true ho pridá a false ho odstráni. Aj zápis disabled="false" pole deaktivuje. Deaktivovaný fieldset deaktivuje aj vnorené polia okrem tých, ktoré sú vnútri jeho prvého priameho potomka legend. Preto môže mať input.disabled hodnotu false, aj keď input.matches(":disabled") vráti true.
Používateľ nemôže deaktivované pole zamerať ani upraviť, ale JavaScript môže jeho hodnotu naďalej meniť. Pole sa nezúčastňuje overovania obmedzení (willValidate je false) a vynecháva sa pri odoslaní formulára aj pri vytváraní new FormData(form). Tieto vlastnosti patria do DOM prehliadača, nie do ECMAScriptu; prostredie bez DOM ich neposkytuje. Prijaté údaje vždy overuj na serveri bez ohľadu na nastavenia poľa.
Príklady
<!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>Výsledok
["10","12",true,false,true] [true,"12",false,false]
Ulož príklad ako súbor `.html`, otvor ho v prehliadači a skontroluj výstup v konzole prehliadača. Hodnota `"12"` prekračuje `"10"` a neprejde overením, ale `FormData` ju napriek tomu obsahuje. Po deaktivácii si pole hodnotu zachová, no vynechá sa pri overovaní aj v údajoch formulára.
Súvisiace lekcie
- JavaScript · Lekcia 28 · Stredne pokročilá · Verzia: 3
Zdroje
- 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