Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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 disabled

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