HTMLButtonElement

Instanzeigenschaften

Erbt Eigenschaften von seinem Elternteil, HTMLElement.

HTMLButtonElement.command

Ein Zeichenfolgenwert, der die Aktion angibt, die auf einem Element durchgeführt werden soll, das durch diesen Button gesteuert wird.

HTMLButtonElement.commandForElement

Ein Verweis auf ein existierendes Element, das durch den Button gesteuert wird.

HTMLButtonElement.disabled

Ein boolescher Wert, der angibt, ob die Steuerung deaktiviert ist, was bedeutet, dass sie keine Klicks akzeptiert.

HTMLButtonElement.form Schreibgeschützt

Ein HTMLFormElement, das das Formular widerspiegelt, mit dem dieser Button verbunden ist. Ist der Button ein Nachkomme eines Formularelements, dann ist dieses Attribut ein Verweis auf das zugehörige HTMLFormElement dieses Formulars. Wenn der Button kein Nachkomme eines Formularelements ist, dann kann das Attribut ein Verweis auf ein beliebiges HTMLFormElement im selben Dokument sein, mit dem es verbunden ist, oder der Wert null, wenn keiner übereinstimmt.

HTMLButtonElement.formAction

Eine Zeichenfolge, die die URI einer Ressource darstellt, die die vom Button übermittelten Informationen verarbeitet. Wenn angegeben, überschreibt dieses Attribut das action-Attribut des <form>-Elements, das dieses Element besitzt.

HTMLButtonElement.formEnctype

Eine Zeichenfolge, die den Typ des Inhalts darstellt, der zur Übermittlung des Formulars an den Server verwendet wird. Wenn angegeben, überschreibt dieses Attribut das enctype-Attribut des <form>-Elements, das dieses Element besitzt.

HTMLButtonElement.formMethod

Eine Zeichenfolge, die die HTTP-Methode darstellt, die der Browser zur Übermittlung des Formulars verwendet. Wenn angegeben, überschreibt dieses Attribut das method-Attribut des <form>-Elements, das dieses Element besitzt.

HTMLButtonElement.formNoValidate

Ein boolescher Wert, der angibt, dass das Formular nicht validiert werden soll, wenn es übermittelt wird. Wenn angegeben, überschreibt dieses Attribut das novalidate-Attribut des <form>-Elements, das dieses Element besitzt.

HTMLButtonElement.formTarget

Eine Zeichenfolge, die einen Namen oder ein Schlüsselwort angibt, der beschreibt, wo die Antwort angezeigt wird, die nach dem Absenden des Formulars empfangen wird. Wenn angegeben, überschreibt dieses Attribut das target-Attribut des <form>-Elements, das dieses Element besitzt.

HTMLButtonElement.interestForElement Experimentell Nicht standardisiert

Holt oder setzt das Zielelement eines "interest invokers" in Fällen, in denen das zugeordnete <button>-Element als interest invoker festgelegt ist.

HTMLButtonElement.labels Schreibgeschützt

Eine NodeList, die eine Liste von <label>-Elementen darstellt, die Labels für diesen Button sind.

HTMLButtonElement.name

Eine Zeichenfolge, die den Namen des Objekts darstellt, wenn es mit einem Formular eingereicht wird. Wenn angegeben, darf es nicht die leere Zeichenfolge sein.

HTMLButtonElement.popoverTargetAction

Holt und setzt die durchzuführende Aktion ("hide", "show" oder "toggle") auf ein Popover-Element, das durch einen Steuerungsbutton gesteuert wird. Es spiegelt den Wert des popovertargetaction HTML-Attributs wider.

HTMLButtonElement.popoverTargetElement

Holt und setzt das Popover-Element, das über einen Button gesteuert wird. Das JavaScript-Äquivalent des popovertarget HTML-Attributs.

HTMLButtonElement.type

Eine Zeichenfolge, die das Verhalten des Buttons angibt. Dies ist ein aufgezähltes Attribut mit den folgenden möglichen Werten:

• submit: Der Button sendet das Formular ab. Dies ist der Standardwert, wenn das Attribut nicht angegeben ist oder wenn es dynamisch in einen leeren oder ungültigen Wert geändert wird.
• reset: Der Button setzt das Formular zurück.
• button: Der Button tut nichts.
• menu: Der Button zeigt ein Menü an. Experimentell

HTMLButtonElement.willValidate Schreibgeschützt

Ein boolescher Wert, der angibt, ob der Button ein Kandidat für die Beschränkungsvalidierung ist. Es ist false, wenn ihn Bedingungen von der Beschränkungsvalidierung ausschließen, einschließlich: seine type-Eigenschaft ist reset oder button; es hat einen <datalist>-Vorfahren; oder die disabled-Eigenschaft ist auf true gesetzt.

HTMLButtonElement.validationMessage Schreibgeschützt

Eine Zeichenfolge, die die lokalisierte Nachricht darstellt, die die Validierungsbeschränkungen beschreibt, die die Steuerung nicht erfüllt (falls vorhanden). Dieses Attribut ist die leere Zeichenfolge, wenn die Kontrolle kein Kandidat für die Beschränkungsvalidierung ist (willValidate ist false) oder wenn es seine Beschränkungen erfüllt.

HTMLButtonElement.validity Schreibgeschützt

Ein ValidityState, das die Gültigkeitszustände darstellt, in denen sich dieser Button befindet.

HTMLButtonElement.value

Eine Zeichenfolge, die den aktuellen Formulareingabewert des Buttons darstellt.

Instanzmethoden

Erbt Methoden von seinem Elternteil, HTMLElement.

HTMLButtonElement.checkValidity()

Gibt true zurück, wenn der Wert des Elements keine Gültigkeitsprobleme aufweist; andernfalls gibt es false zurück.

HTMLButtonElement.reportValidity()

Führt die gleiche Aktion wie checkValidity() aus, meldet jedoch auch das Ergebnis dem Benutzer, wenn das invalid-Ereignis nicht abgebrochen wurde.

HTMLButtonElement.setCustomValidity()

Setzt die benutzerdefinierte Fehlermeldung für das Element. Verwenden Sie die leere Zeichenfolge, um anzugeben, dass das Element keinen benutzerdefinierten Gültigkeitsfehler hat.

Spezifikationen

Browser-Kompatibilität

Siehe auch

• HTML-Element, das dieses Interface implementiert: <button>