CKTIS / JavaScript
HTMLInputElement.max und disabled: Wertgrenzen und deaktivierte Eingabefelder
`max` spiegelt die Obergrenze als Zeichenfolge wider, `disabled` das Vorhandensein des eigenen Deaktivierungsattributs. Eine Grenzüberschreitung deaktiviert das Feld nicht.
Version: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
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 disabledDie schreibbare Zeichenfolgen-Eigenschaft input.max spiegelt das HTML-Attribut max wider. Sie liefert dessen Text oder "", wenn es fehlt, nicht die berechnete Obergrenze. input.max = "10" setzt das Attribut; input.removeAttribute("max") entfernt es.
max gilt für number, range, date, month, week, time und datetime-local; das Format hängt vom Typ ab. Es begrenzt nicht die Textlänge. Fehlt das Attribut oder lässt es sich nicht auswerten, gilt die Standardobergrenze des Typs, sofern vorhanden: bei range 100, bei number gibt es keine. Eine Zahl oberhalb der Grenze bleibt bei number in value und führt zu validity.rangeOverflow === true. Ein range-Schieberegler passt seinen Wert dagegen an den Bereich an. Bei time kann ein Bereich mit min größer als max über Mitternacht reichen.
Die schreibbare boolesche Eigenschaft input.disabled zeigt an, ob das Feld ein eigenes disabled-Attribut hat. true fügt es hinzu, false entfernt es. Auch disabled="false" deaktiviert das Feld. Ein deaktiviertes fieldset deaktiviert zudem untergeordnete Eingabefelder, außer denen innerhalb seines ersten direkten legend-Kindelements. Daher kann input.disabled den Wert false haben, obwohl input.matches(":disabled") den Wert true liefert.
Ein deaktiviertes Feld lässt sich nicht fokussieren oder durch Benutzende bearbeiten; JavaScript kann seinen Wert weiterhin ändern. Es nimmt nicht an der Prüfung von Eingabebeschränkungen teil (willValidate ist false) und fehlt beim Absenden des Formulars sowie in new FormData(form). Diese Eigenschaften gehören zum Browser-DOM, nicht zu ECMAScript; eine Laufzeit ohne DOM stellt sie nicht bereit. Prüfe empfangene Daten unabhängig von den Feldeinstellungen auf dem Server.
Beispiele
<!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>Ergebnis
["10","12",true,false,true] [true,"12",false,false]
Speichere das Beispiel als `.html`-Datei, öffne es im Browser und prüfe die Ausgabe in der Browserkonsole. `"12"` überschreitet `"10"` und besteht die Prüfung nicht, ist aber trotzdem in `FormData` enthalten. Nach der Deaktivierung bleibt der Wert erhalten, wird jedoch weder geprüft noch in die Formulardaten aufgenommen.
Zugehörige Lektionen
- JavaScript · Lektion 28 · Mittlere Stufe · Version: 3
Quellen
- 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