HTMLOutputElement

Baseline Weitgehend verfügbar *

Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit August 2016 browserübergreifend verfügbar.

* Einige Teile dieser Funktion werden möglicherweise unterschiedlich gut unterstützt.

Das HTMLOutputElement-Interface bietet Eigenschaften und Methoden (über die von HTMLElement geerbten hinaus) zur Manipulation des Layouts und der Darstellung von <output>-Elementen.

Konstruktor

HTMLOutputElement() Experimentell: Erstellt ein neues HTMLOutputElement-Objekt.

Instanz-Eigenschaften

Dieses Interface erbt auch Eigenschaften von seinem Elternteil, HTMLElement.

HTMLOutputElement.defaultValue: Ein String, der den Standardwert des Elements darstellt, anfangs der leere String.
HTMLOutputElement.form Schreibgeschützt: Ein HTMLFormElement, das das Formular angibt, das mit dem Steuerelement verbunden ist, wobei das form-HTML-Attribut widergespiegelt wird, falls es definiert ist.
HTMLOutputElement.htmlFor Schreibgeschützt: Ein DOMTokenList, das das for-HTML-Attribut widergespiegelt, enthält eine Liste von IDs anderer Elemente im selben Dokument, die zur Berechnung des 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 widergespiegelt, enthält den Namen für das Steuerelement, der mit den Formulardaten übermittelt wird.
HTMLOutputElement.type Schreibgeschützt: Der String "output".
HTMLOutputElement.validationMessage Schreibgeschützt: Ein String, der eine lokalisierte Nachricht darstellt, die die Validierungsbeschränkungen beschreibt, die das Steuerelement nicht erfüllt (falls vorhanden). Dies ist der leere String, wenn das Steuerelement kein Kandidat für die Überprüfung von Constraints ist (willValidate ist false), oder es erfüllt seine Beschränkungen.
HTMLOutputElement.validity Schreibgeschützt: Ein ValidityState, das die Validitätszustä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 anzeigt, ob das Element ein Kandidat für die Überprüfung von Constraints 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 mit dem Ergebnis der Überprüfung zurück.

HTMLOutputElement.reportValidity()

Diese Methode meldet dem Benutzer die Probleme mit den Constraints des Elements, falls vorhanden. Bei Problemen löst sie ein invalid-Ereignis auf dem Element aus und gibt false zurück; treten keine Probleme auf, gibt sie true zurück.

Wenn das Problem gemeldet wird, kann die Benutzeroberfläche das Element fokussieren und die Bildlaufposition des Dokuments ändern oder eine andere Aktion ausführen, die das Element in den Fokus des Benutzers rückt. Benutzeroberflächen können mehr als eine Verletzung von Constraints melden, wenn dieses Element gleichzeitig von mehreren Problemen betroffen ist. Wenn das Element nicht gerendert wird, kann die Benutzeroberfläche den Fehler stattdessen für das ausgeführte Skript melden, anstatt den Benutzer zu benachrichtigen.

HTMLOutputElement.setCustomValidity()

Setzt eine benutzerdefinierte Validitätsnachricht für das Element. Wenn diese Nachricht nicht der leere String ist, leidet das Element unter einem benutzerdefinierten Validitätsfehler und wird nicht validiert.

Modi

Dieses Element verhält sich in einem von zwei Modi: Standard-Modus und Wert-Modus.

Standard-Modus

Anfangs befindet sich das Element im Standard-Modus, und der Inhalt des Elements stellt sowohl den Wert des Elements als auch seinen Standardwert dar.

Wenn sich das Element im Standard-Modus befindet und die Nachfahren des Elements in irgendeiner 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 Standard-Modus und setzt die textContent-Eigenschaft auf den Wert der defaultValue-Eigenschaft.

Wert-Modus

Das Element geht in den Wert-Modus über, wenn der Inhalt der value-Eigenschaft gesetzt wird. Die value-Eigenschaft verhält sich ansonsten wie die textContent-Eigenschaft. Wenn sich das Element im Wert-Modus befindet, ist der Standardwert nur über die defaultValue-Eigenschaft zugänglich.

Spezifikationen

Spezifikation
HTML # htmloutputelement

Browser-Kompatibilität

Siehe auch

Das HTML-Element, das dieses Interface implementiert: <output>.

Help improve MDN

Erfahren Sie, wie Sie beitragen können Diese Seite wurde automatisch aus dem Englischen übersetzt.

Übersetzung auf GitHub anzeigen • Fehler mit dieser Übersetzung melden