CKTIS / JavaScript
HTMLInputElement.max i disabled: gornja granica i onemogućavanje polja
`max` odražava gornju granicu kao niz znakova, a `disabled` pokazuje ima li polje vlastiti atribut za onemogućavanje. Prekoračenje granice ne onemogućuje polje.
Verzija: 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 svojstvo tipa niza znakova koje se može mijenjati i odražava HTML atribut max. Vraća tekst atributa ili "" ako atribut nedostaje, a ne izračunatu gornju granicu. input.max = "10" postavlja atribut, a input.removeAttribute("max") ga uklanja.
max vrijedi za tipove number, range, date, month, week, time i datetime-local; format ovisi o tipu. Ne ograničava duljinu teksta. Ako atribut nedostaje ili se ne može protumačiti, primjenjuje se zadana gornja granica tipa, ako postoji: za range to je 100, a number nema zadanu granicu. U polju number broj iznad granice ostaje u value i vrijedi validity.rangeOverflow === true. Klizač range umjesto toga prilagođava vrijednost rasponu. Raspon time s min većim od max može prelaziti preko ponoći.
Promjenjivo Booleovo svojstvo input.disabled odražava prisutnost atributa disabled na samom polju. true dodaje atribut, a false ga uklanja. I zapis disabled="false" onemogućuje polje. Onemogućeni fieldset onemogućuje i polja koja su njegovi potomci, osim onih unutar njegova prvog izravnog djeteta legend. Zato input.disabled može biti false iako input.matches(":disabled") vraća true.
Korisnik ne može fokusirati ni uređivati onemogućeno polje, ali JavaScript i dalje može promijeniti njegovu vrijednost. Polje ne sudjeluje u provjeri ograničenja (willValidate je false) i izostavlja se pri slanju obrasca i pri izradi new FormData(form). Ta svojstva pripadaju DOM-u preglednika, a ne ECMAScriptu; okruženje bez DOM-a ne pruža ih. Primljene podatke uvijek provjeri na poslužitelju, neovisno o postavkama polja.
Primjeri
<!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]
Spremi primjer kao `.html` datoteku, otvori je u pregledniku i provjeri ispis u konzoli preglednika. Vrijednost `"12"` prelazi `"10"` i ne prolazi provjeru, ali je `FormData` ipak sadrži. Nakon onemogućavanja polje zadržava vrijednost, no izostavlja se iz provjere i podataka obrasca.
Povezane lekcije
- JavaScript · Lekcija 28 · Srednje · Verzija: 3
Izvori
- 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