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.

* 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 Präsentation von <output>-Elementen.

EventTarget Node Element HTMLElement HTMLOutputElement

Instanz-Eigenschaften

Dieses Interface erbt ebenfalls Eigenschaften von seinem Elternteil, HTMLElement.

HTMLOutputElement.defaultValue

Ein String, der den Standardwert des Elements darstellt, der anfangs der leere String ist.

HTMLOutputElement.form Schreibgeschützt

Ein HTMLFormElement, das das mit dem Steuerelement verbundene Formular anzeigt und das form-HTML-Attribut widerspiegelt, sofern es definiert ist.

HTMLOutputElement.htmlFor Schreibgeschützt

Eine DOMTokenList, die das for-HTML-Attribut widerspiegelt und eine Liste von IDs anderer Elemente im selben Dokument enthält, die zum berechneten value beitragen (oder diesen beeinflussen).

HTMLOutputElement.labels Schreibgeschützt

Eine NodeList von <label>-Elementen, die dem Element zugeordnet sind.

HTMLOutputElement.name

Ein String, der das name-HTML-Attribut widerspiegelt und den Namen für das Steuerelement 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 Validierungseinschränkungen erläutert, 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 wenn es seine Einschrä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 ähnlich wie die Node.textContent-Eigenschaft.

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 ebenfalls 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 die Probleme mit den Einschränkungen des Elements, falls vorhanden, dem Benutzer. Wenn es Probleme gibt, löst sie ein invalid-Ereignis am Element aus und gibt false zurück; wenn es keine Probleme gibt, gibt sie true zurück.

Wenn das Problem gemeldet wird, kann der Benutzeragent das Element fokussieren und die Scroll-Position des Dokuments ändern oder eine andere Aktion ausführen, die das Element in den Vordergrund des Benutzers rückt. Benutzeragenten können mehr als einen Einschränkungsverstoß melden, wenn dieses Element gleichzeitig unter mehreren Problemen leidet. Wenn das Element nicht gerendert wird, kann der Benutzeragent den Fehler für das laufende Skript anstelle der Benutzerbenachrichtigung melden.

HTMLOutputElement.setCustomValidity()

Legt eine benutzerdefinierte Gültigkeitsnachricht für das Element fest. Wenn diese Nachricht nicht der leere String ist, leidet das Element unter einem benutzerdefinierten Gültigkeitsfehler und wird nicht validiert.

Modi

Dieses Element verhält sich in einem von zwei Modi: Standardmodus und Wertmodus.

Standardmodus

Anfangs befindet sich das Element im Standardmodus, und so repräsentiert der Inhalt des Elements sowohl den Wert des Elements als auch seinen Standardwert.

Wenn sich das Element im Standardmodus befindet und die Nachfahren des Elements auf irgendeine Weise geändert werden, wird die defaultValue-Eigenschaft auf den Wert der textContent-Eigenschaft gesetzt.

Das Zurücksetzen des Formulars versetzt das Element in den Standardmodus und setzt die textContent-Eigenschaft auf den Wert der defaultValue-Eigenschaft.

Wertmodus

Das Element wechselt in den Wertmodus, wenn der Inhalt der value-Eigenschaft gesetzt wird. Die value-Eigenschaft verhält sich ansonsten wie die textContent-Eigenschaft. Wenn sich das Element im Wertmodus befindet, 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>.