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.
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 dasform
-HTML-Attribut widerspiegelt, sofern es definiert ist. HTMLOutputElement.htmlFor
Schreibgeschützt-
Eine
DOMTokenList
, die dasfor
-HTML-Attribut widerspiegelt und eine Liste von IDs anderer Elemente im selben Dokument enthält, die zum berechnetenvalue
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
istfalse
) 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ürHTMLOutputElement
-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 gibtfalse
zurück; wenn es keine Probleme gibt, gibt sietrue
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>
.