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.

EventTarget Node Element HTMLElement HTMLOutputElement

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

HTMLOutputElement.htmlFor Schreibgeschützt

Eine DOMTokenList, die das HTML-Attribut for 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

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 ist false) 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ür HTMLOutputElement-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 und false zurückgegeben; wenn keine Probleme vorliegen, wird true 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>.