DasHTMLButtonElement Interface bietet Eigenschaften und Methoden (zusätzlich zu denen des regulärenHTMLElement Interfaces, die es ebenfalls durch Vererbung besitzt) zur Manipulation von<button>-Elementen.

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 existierendesElement, 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.formSchreibgeschützt

EinHTMLFormElement, 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örigeHTMLFormElement dieses Formulars. Wenn der Button kein Nachkomme eines Formularelements ist, dann kann das Attribut ein Verweis auf ein beliebigesHTMLFormElement im selben Dokument sein, mit dem es verbunden ist, oder der Wertnull, 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 dasaction-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 dasenctype-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 dasmethod-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 dasnovalidate-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 dastarget-Attribut des<form>-Elements, das dieses Element besitzt.

HTMLButtonElement.interestForElementExperimentellNicht standardisiert

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

HTMLButtonElement.labelsSchreibgeschützt

EineNodeList, 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 despopovertargetaction HTML-Attributs wider.

HTMLButtonElement.popoverTargetElement

Holt und setzt das Popover-Element, das über einen Button gesteuert wird. Das JavaScript-Äquivalent despopovertarget 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.willValidateSchreibgeschützt

Ein boolescher Wert, der angibt, ob der Button ein Kandidat für die Beschränkungsvalidierung ist. Es istfalse, wenn ihn Bedingungen von der Beschränkungsvalidierung ausschließen, einschließlich: seinetype-Eigenschaft istreset oderbutton; es hat einen<datalist>-Vorfahren; oder diedisabled-Eigenschaft ist auftrue gesetzt.

HTMLButtonElement.validationMessageSchreibgeschü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 istfalse) oder wenn es seine Beschränkungen erfüllt.

HTMLButtonElement.validitySchreibgeschützt

EinValidityState, 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()

Gibttrue zurück, wenn der Wert des Elements keine Gültigkeitsprobleme aufweist; andernfalls gibt esfalse zurück.

HTMLButtonElement.reportValidity()

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

HTMLButtonElement.setCustomValidity()

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

Spezifikationen

Browser-Kompatibilität

Siehe auch

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