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.

EventTarget Node Element HTMLElement HTMLOutputElement

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 das form HTML-Attribut widerspiegelt, wenn es definiert ist.

HTMLOutputElement.htmlFor Schreibgeschützt

Ein DOMTokenList, das das for HTML-Attribut widerspiegelt und eine Liste von IDs anderer Elemente im selben Dokument enthält, die zu dem berechneten value 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 ist false) 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 immer false.

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 wird false zurückgegeben; wenn es keine Probleme gibt, wird true 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>.