CKTIS / JavaScript
HTMLInputElement.max in disabled: zgornja meja in onemogočanje polja
`max` odraža zgornjo mejo kot niz, `disabled` pa pove, ali ima polje lasten atribut za onemogočanje. Če vrednost preseže mejo, polje zato še ni onemogočeno.
Različica: ECMAScript 2024 and the current web platform; runtime support varies
Sintaksa
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 zapisljiva lastnost tipa niz, ki odraža atribut HTML max. Vrne besedilo atributa oziroma "", če atribut manjka, ne pa izračunane zgornje meje. input.max = "10" nastavi atribut, input.removeAttribute("max") pa ga odstrani.
max velja za tipe number, range, date, month, week, time in datetime-local; oblika zapisa je odvisna od tipa. Ne omejuje dolžine besedila. Če atribut manjka ali ga ni mogoče razčleniti, velja privzeta zgornja meja tipa, če obstaja: za range je to 100, za number je ni. V polju number število nad mejo ostane v value in velja validity.rangeOverflow === true. Drsnik range pa vrednost prilagodi razponu. Razpon time, pri katerem je min večji od max, lahko sega čez polnoč.
Zapisljiva logična lastnost input.disabled odraža prisotnost atributa disabled na samem polju. true ga doda, false pa odstrani. Tudi disabled="false" onemogoči polje. Onemogočen fieldset onemogoči tudi podrejena polja, razen tistih znotraj njegovega prvega neposrednega otroka legend. Zato je lahko input.disabled enak false, čeprav input.matches(":disabled") vrne true.
Uporabnik onemogočenega polja ne more postaviti v fokus ali urejati, JavaScript pa še vedno lahko spremeni njegovo vrednost. Polje je izvzeto iz preverjanja omejitev (willValidate je false) in izpuščeno pri oddaji obrazca ter pri ustvarjanju new FormData(form). Ti lastnosti sta del brskalnikovega DOM-a, ne ECMAScripta; okolje brez DOM-a ju ne zagotavlja. Prejete podatke vedno preveri na strežniku, ne glede na nastavitve polja.
Primeri
<!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>Rezultat
["10","12",true,false,true] [true,"12",false,false]
Shrani primer kot datoteko `.html`, odpri jo v brskalniku in preveri izpis v brskalnikovi konzoli. Vrednost `"12"` presega `"10"` in ne prestane preverjanja, vendar jo `FormData` vseeno vsebuje. Ko je polje onemogočeno, obdrži vrednost, vendar je izvzeto iz preverjanja in izpuščeno iz podatkov obrazca.
Povezane lekcije
- JavaScript · Lekcija 28 · Srednja · Različica: 3
Viri
- 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