CKTIS / JavaScript
HTMLInputElement.max a disabled: horní mez a deaktivace pole
`max` odráží horní mez jako řetězec, zatímco `disabled` udává, zda má pole vlastní atribut pro deaktivaci. Překročení meze pole nedeaktivuje.
Verze: ECMAScript 2024 and the current web platform; runtime support varies
Syntaxe
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 zapisovatelná řetězcová vlastnost odrážející HTML atribut max. Vrací text atributu, nebo "", pokud atribut chybí, nikoli vypočtenou horní mez. input.max = "10" atribut nastaví a input.removeAttribute("max") jej odstraní.
max platí pro typy number, range, date, month, week, time a datetime-local; formát závisí na typu. Neomezuje délku textu. Pokud atribut chybí nebo ho nelze převést podle formátu daného typu, použije se jeho výchozí horní mez, pokud existuje: u range je to 100, u number žádná není. V poli number číslo nad mezí zůstane ve value a platí validity.rangeOverflow === true. Posuvník range naopak hodnotu upraví podle rozsahu. Rozsah time s min větším než max může přecházet přes půlnoc.
Zapisovatelná booleovská vlastnost input.disabled odráží přítomnost atributu disabled přímo na poli. true atribut přidá a false jej odstraní. I zápis disabled="false" pole deaktivuje. Deaktivovaný fieldset deaktivuje také vnořená pole kromě těch, která jsou uvnitř jeho prvního přímého potomka legend. Proto může být input.disabled rovno false, i když input.matches(":disabled") vrací true.
Deaktivované pole nelze zaměřit ani upravit uživatelským vstupem, ale JavaScript může jeho hodnotu stále změnit. Pole se neúčastní ověřování omezení (willValidate je false) a vynechává se při odesílání formuláře i při vytváření new FormData(form). Tyto vlastnosti jsou součástí DOM prohlížeče, nikoli ECMAScriptu; prostředí bez DOM je neposkytuje. Přijatá data vždy ověřuj na serveru bez ohledu na nastavení pole.
Pří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ýsledek
["10","12",true,false,true] [true,"12",false,false]
Ulož příklad jako soubor `.html`, otevři jej v prohlížeči a zkontroluj výstup v konzoli prohlížeče. Hodnota `"12"` překračuje `"10"` a neprojde ověřením, ale `FormData` ji přesto obsahuje. Po deaktivaci si pole hodnotu ponechá, ale vynechá se při ověřování i v datech formuláře.
Související lekce
- JavaScript · Lekce 28 · Středně pokročilá · Verze: 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