HTMLOutputElement
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since October 2018.
Die Schnittstelle HTMLOutputElement
bietet Eigenschaften und Methoden (zusätzlich zu denen, die von HTMLElement
geerbt werden) zur Manipulation des Layouts und der Darstellung von <output>
Elementen.
Instanz-Eigenschaften
Diese Schnittstelle erbt auch Eigenschaften von ihrem Elternteil, HTMLElement
.
HTMLOutputElement.defaultValue
-
Ein String, der den Standardwert des Elements darstellt, anfangs der leere String.
HTMLOutputElement.form
Schreibgeschützt-
Ein
HTMLFormElement
, das das mit dem Steuerelement assoziierte Formular anzeigt, das dasform
HTML-Attribut widerspiegelt, wenn es definiert ist. HTMLOutputElement.htmlFor
Schreibgeschützt-
Ein
DOMTokenList
, das dasfor
HTML-Attribut 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-
Ein
NodeList
von<label>
Elementen, die mit dem Element verbunden sind. HTMLOutputElement.name
-
Ein String, der das
name
HTML-Attribut widerspiegelt und den Namen für das Steuerelement enthält, der mit den Formulardaten übermittelt wird. HTMLOutputElement.type
Schreibgeschützt-
Der String
"output"
. HTMLOutputElement.validationMessage
Schreibgeschützt-
Ein String, der eine lokalisierte Nachricht beschreibt, die die Validierungseinschränkungen beschreibt, die das Steuerelement nicht erfüllt (falls vorhanden). Dies ist der leere String, wenn das Steuerelement kein Kandidat für die Einschränkungsvalidierung ist (
willValidate
istfalse
) oder es erfüllt seine Einschränkungen. HTMLOutputElement.validity
Schreibgeschützt-
Ein
ValidityState
, das 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
Node.textContent
Eigenschaft. HTMLOutputElement.willValidate
Schreibgeschützt-
Gibt einen booleschen Wert zurück, der angibt, ob das Element ein Kandidat für die Einschränkungsvalidierung ist. Für
HTMLOutputElement
-Objekte immerfalse
.
Instanz-Methoden
Diese Schnittstelle erbt auch Methoden von ihrem Elternteil, HTMLElement
.
HTMLOutputElement.checkValidity()
-
Überprüft die Gültigkeit des Elements und gibt einen booleschen Wert zurück, der das Prüfungsergebnis 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 und es wirdfalse
zurückgegeben; wenn es keine Probleme gibt, wirdtrue
zurückgegeben.Wenn das Problem gemeldet wird, kann der Benutzeragent das Element fokussieren und die Scrollposition des Dokuments ändern oder eine andere Aktion durchführen, die das Element auf die Aufmerksamkeit des Benutzers lenkt. Benutzeragenten können mehr als eine Einschränkungsverletzung melden, wenn dieses Element gleichzeitig unter mehreren Problemen leidet. Wenn das Element nicht gerendert wird, kann der Benutzeragent den Fehler stattdessen für das laufende Skript melden, anstatt den Benutzer zu benachrichtigen.
HTMLOutputElement.setCustomValidity()
-
Setzt eine benutzerdefinierte Fehlermeldung für das Element. Wenn diese Nachricht nicht der leere String ist, leidet das Element unter einem benutzerdefinierten Validierungsfehler und validiert nicht.
Modi
Dieses Element verhält sich in einem von zwei Modi: default Modus und value Modus.
Default Modus
Zunächst ist das Element im Default-Modus, und so stellen die Inhalte des Elements sowohl den Wert des Elements als auch dessen Standardwert dar.
Wenn das Element im Default-Modus ist, wenn die Nachfahren des Elements in irgendeiner Weise geändert werden, wird die Eigenschaft defaultValue
auf den Wert der textContent
Eigenschaft gesetzt.
Das Zurücksetzen des Formulars versetzt das Element in den Default-Modus und setzt die Eigenschaft textContent
auf den Wert der Eigenschaft defaultValue
.
Value Modus
Das Element wechselt in den Value-Modus, wenn die Inhalte der Eigenschaft value
gesetzt werden. Die Eigenschaft value
verhält sich ansonsten wie die textContent
Eigenschaft. Wenn das Element im Value-Modus ist, ist der Standardwert nur über die Eigenschaft defaultValue
zugänglich.
Spezifikationen
Specification |
---|
HTML Standard # htmloutputelement |
Browser-Kompatibilität
BCD tables only load in the browser
Siehe auch
- Das HTML-Element, das diese Schnittstelle implementiert:
<output>
.