Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

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 disabled

input.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