HTMLOutputElement
Baseline Widely available *
This feature is well established and works across many devices and browser versions. It’s been available across browsers since August 2016.
* Some parts of this feature may have varying levels of support.
Das HTMLOutputElement
-Interface bietet Eigenschaften und Methoden (über die von HTMLElement
geerbten hinaus) zur Manipulation des Layouts und der Darstellung von <output>
-Elementen.
Instanz-Eigenschaften
Dieses Interface erbt auch Eigenschaften von seinem Elternteil, HTMLElement
.
HTMLOutputElement.defaultValue
-
Ein String, der den Standardwert des Elements darstellt, anfänglich der leere String.
HTMLOutputElement.form
Schreibgeschützt-
Ein
HTMLFormElement
, das das Formular anzeigt, das mit der Steuerung verbunden ist und das HTML-Attributform
widerspiegelt, wenn es definiert ist. HTMLOutputElement.htmlFor
Schreibgeschützt-
Eine
DOMTokenList
, die das HTML-Attributfor
widerspiegelt und eine Liste von IDs anderer Elemente im selben Dokument enthält, die zu dem berechnetenvalue
beitragen (oder es anderweitig beeinflussen). HTMLOutputElement.labels
Schreibgeschützt-
Eine
NodeList
von<label>
-Elementen, die mit dem Element assoziiert sind. HTMLOutputElement.name
-
Ein String, der das HTML-Attribut
name
widerspiegelt und den Namen für die Steuerung enthält, der mit Formulardaten übermittelt wird. HTMLOutputElement.type
Schreibgeschützt-
Der String
"output"
. HTMLOutputElement.validationMessage
Schreibgeschützt-
Ein String, der eine lokalisierte Nachricht beschreibt, die die Validierungsbeschränkungen erklärt, die die Steuerung nicht erfüllt (falls vorhanden). Dies ist der leere String, wenn die Steuerung kein Kandidat für die Einschränkungsvalidierung ist (
willValidate
istfalse
) oder ihre Beschränkungen erfüllt. HTMLOutputElement.validity
Schreibgeschützt-
Ein
ValidityState
, der die Gültigkeitszustände darstellt, in denen sich dieses Element befindet. HTMLOutputElement.value
-
Ein String, der den Wert des Inhalts der Elemente darstellt. Verhält sich wie die Eigenschaft
Node.textContent
. HTMLOutputElement.willValidate
Schreibgeschützt-
Gibt einen booleschen Wert zurück, der anzeigt, ob das Element ein Kandidat für die Einschränkungsvalidierung ist. Immer
false
fürHTMLOutputElement
-Objekte.
Instanz-Methoden
Dieses Interface erbt auch Methoden von seinem Elternteil, HTMLElement
.
HTMLOutputElement.checkValidity()
-
Überprüft die Gültigkeit des Elements und gibt einen booleschen Wert zurück, der das Ergebnis der Überprüfung enthält.
HTMLOutputElement.reportValidity()
-
Diese Methode meldet dem Benutzer die Probleme mit den Einschränkungen des Elements, falls vorhanden. Wenn es Probleme gibt, wird ein
invalid
-Ereignis am Element ausgelöst undfalse
zurückgegeben; wenn keine Probleme vorliegen, wirdtrue
zurückgegeben.Wenn das Problem gemeldet wird, kann der Benutzeragent das Element in den Fokus rücken und die Scrollposition des Dokuments ändern oder eine andere Aktion ausführen, um das Element in den Fokus des Benutzers zu rücken. Benutzeragenten können mehr als eine Einschränkungsverletzung melden, wenn dieses Element unter mehreren Problemen gleichzeitig leidet. Wenn das Element nicht gerendert wird, kann der Benutzeragent den Fehler für das laufende Skript melden, anstatt den Benutzer zu benachrichtigen.
HTMLOutputElement.setCustomValidity()
-
Legt eine benutzerdefinierte Fehlermeldung für das Element fest. Wenn diese Nachricht nicht der leere String ist, dann leidet das Element unter einem benutzerdefinierten Gültigkeitsfehler und wird nicht validiert.
Modi
Dieses Element verhält sich in einem von zwei Modi: default-Modus und value-Modus.
Default-Modus
Anfangs befindet sich das Element im Default-Modus, und der Inhalt des Elements repräsentiert sowohl den Wert des Elements als auch seinen Standardwert.
Wenn das Element im Default-Modus ist, wenn die Nachkommen des Elements auf irgendeine Weise geändert werden, wird die Eigenschaft defaultValue
auf den Wert der Eigenschaft textContent
gesetzt.
Das Zurücksetzen des Formulars versetzt das Element in den Default-Modus und setzt die Eigenschaft textContent
auf den Wert der defaultValue
-Eigenschaft.
Value-Modus
Das Element wechselt in den Value-Modus, wenn der Inhalt der value
-Eigenschaft gesetzt wird. Die value
-Eigenschaft verhält sich ansonsten wie die Eigenschaft textContent
. Wenn das Element im Value-Modus ist, ist der Standardwert nur über die defaultValue
-Eigenschaft zugänglich.
Spezifikationen
Specification |
---|
HTML # htmloutputelement |
Browser-Kompatibilität
Siehe auch
- Das HTML-Element, das dieses Interface implementiert:
<output>
.