HTMLOutputElement

Konstruktor

HTMLOutputElement()

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 Schreibgeschtzt

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 Schreibgeschtzt

Ein DOMTokenList, das das for-HTML-Attribut widergespiegelt, enthlt eine Liste von IDs anderer Elemente im selben Dokument, die zur Berechnung des value beitragen (oder es anderweitig beeinflussen).

HTMLOutputElement.labels Schreibgeschtzt

Ein NodeList von <label>-Elementen, die mit dem Element verbunden sind.

HTMLOutputElement.name

Ein String, der das name-HTML-Attribut widergespiegelt, enthlt den Namen fr das Steuerelement, der mit den Formulardaten bermittelt wird.

HTMLOutputElement.type Schreibgeschtzt

Der String "output".

HTMLOutputElement.validationMessage Schreibgeschtzt

Ein String, der eine lokalisierte Nachricht darstellt, die die Validierungsbeschrnkungen beschreibt, die das Steuerelement nicht erfllt (falls vorhanden). Dies ist der leere String, wenn das Steuerelement kein Kandidat fr die berprfung von Constraints ist (willValidate ist false), oder es erfllt seine Beschrnkungen.

HTMLOutputElement.validity Schreibgeschtzt

Ein ValidityState, das die Validittszustnde darstellt, in denen sich dieses Element befindet.

HTMLOutputElement.value

Ein String, der den Wert des Inhalts der Elemente darstellt. Verhlt sich wie die Node.textContent-Eigenschaft.

HTMLOutputElement.willValidate Schreibgeschtzt

Gibt einen booleschen Wert zurck, der anzeigt, ob das Element ein Kandidat fr die berprfung von Constraints ist. Immer false fr HTMLOutputElement-Objekte.

Instanz-Methoden

Dieses Interface erbt auch Methoden von seinem Elternteil, HTMLElement.

HTMLOutputElement.checkValidity()

berprft die Gltigkeit des Elements und gibt einen booleschen Wert mit dem Ergebnis der berprfung zurck.

HTMLOutputElement.reportValidity()

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

Wenn das Problem gemeldet wird, kann die Benutzeroberflche das Element fokussieren und die Bildlaufposition des Dokuments ndern oder eine andere Aktion ausfhren, die das Element in den Fokus des Benutzers rckt. Benutzeroberflchen knnen mehr als eine Verletzung von Constraints melden, wenn dieses Element gleichzeitig von mehreren Problemen betroffen ist. Wenn das Element nicht gerendert wird, kann die Benutzeroberflche den Fehler stattdessen fr das ausgefhrte Skript melden, anstatt den Benutzer zu benachrichtigen.

HTMLOutputElement.setCustomValidity()

Setzt eine benutzerdefinierte Validittsnachricht fr das Element. Wenn diese Nachricht nicht der leere String ist, leidet das Element unter einem benutzerdefinierten Validittsfehler und wird nicht validiert.

Modi

Dieses Element verhlt 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 gendert werden, wird die defaultValue-Eigenschaft auf den Wert der textContent-Eigenschaft gesetzt.

Das Zurcksetzen 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 verhlt sich ansonsten wie die textContent-Eigenschaft. Wenn sich das Element im Wert-Modus befindet, ist der Standardwert nur ber die defaultValue-Eigenschaft zugnglich.

Spezifikationen

Spezifikation
HTML # htmloutputelement

Browser-Kompatibilitt

Siehe auch

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