HTMLButtonElement

Baseline Widely available *

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

* Some parts of this feature may have varying levels of support.

Das HTMLButtonElement Interface stellt Eigenschaften und Methoden (über die reguläre HTMLElement Schnittstelle hinaus, die es auch durch Vererbung verfügbar hat) zur Manipulation von <button>-Elementen zur Verfügung.

EventTarget Node Element HTMLElement HTMLButtonElement

Instanzeigenschaften

Erbt Eigenschaften von seinem Elternteil, HTMLElement.

HTMLButtonElement.command

Ein Zeichenfolgenwert, der die Aktion angibt, die bei einem vom Button gesteuerten Element ausgeführt werden soll.

HTMLButtonElement.commandForElement

Ein Verweis auf ein vorhandenes Element, das vom 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 verknüpft ist. Ist der Button ein Nachkomme eines Formularelements, dann ist dieses Attribut ein Verweis auf das zugehörige HTMLFormElement des Formulars. Wenn der Button nicht ein Nachkomme eines Formularelements ist, kann das Attribut ein Verweis auf jedes HTMLFormElement-Element im selben Dokument sein, mit dem es verbunden ist, oder den Wert null haben, wenn keine Übereinstimmung vorliegt.

HTMLButtonElement.formAction

Eine Zeichenfolge, die die URI einer Ressource widerspiegelt, die von dem Button übermittelte Informationen verarbeitet. Wenn angegeben, überschreibt dieses Attribut das action Attribut des <form> Elements, dem dieses Element gehört.

HTMLButtonElement.formEnctype

Eine Zeichenfolge, die den Inhaltstyp widerspiegelt, der verwendet wird, um das Formular an den Server zu übermitteln. Wenn angegeben, überschreibt dieses Attribut das enctype Attribut des <form> Elements, dem dieses Element gehört.

HTMLButtonElement.formMethod

Eine Zeichenfolge, die das HTTP-Verfahren widerspiegelt, das der Browser verwendet, um das Formular zu übermitteln. Wenn angegeben, überschreibt dieses Attribut das method Attribut des <form> Elements, dem dieses Element gehört.

HTMLButtonElement.formNoValidate

Ein boolescher Wert, der anzeigt, dass das Formular nicht validiert werden soll, wenn es übermittelt wird. Wenn angegeben, überschreibt dieses Attribut das novalidate Attribut des <form> Elements, dem dieses Element gehört.

HTMLButtonElement.formTarget

Eine Zeichenfolge, die einen Namen oder ein Schlüsselwort widerspiegelt, das angibt, wo die Antwort angezeigt werden soll, die nach dem Absenden des Formulars empfangen wurde. Wenn angegeben, überschreibt dieses Attribut das target Attribut des <form> Elements, dem dieses Element gehört.

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 bei der Übermittlung mit einem Formular darstellt. Wenn angegeben, darf sie nicht die leere Zeichenfolge sein.

HTMLButtonElement.popoverTargetAction

Ruft die Aktion ab, die auf ein durch einen Kontrollknopf gesteuertes Popover-Element ausgeführt werden soll ("hide", "show" oder "toggle"), oder setzt sie. Es spiegelt den Wert des popovertargetaction HTML-Attributs wider.

HTMLButtonElement.popoverTargetElement

Ruft das Popover-Element ab oder setzt es, das über einen Button gesteuert werden soll. 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 übermittelt das Formular. Dies ist der Standardwert, wenn das Attribut nicht angegeben ist oder es auf einen leeren oder ungültigen Wert dynamisch 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 Einschränkungsvalidierung ist. Es ist false, wenn Bedingungen es von der Einschrä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 Steuerung kein Kandidat für die Einschränkungsvalidierung ist (willValidate ist false), oder wenn es seine Einschrä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 Formularsteuerwert 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 wird false zurückgegeben.

HTMLButtonElement.reportValidity()

Führt die gleiche Aktion wie checkValidity() aus, meldet aber das Ergebnis auch 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

Specification
HTML
# htmlbuttonelement

Browser-Kompatibilität

Siehe auch

  • HTML-Element, das diese Schnittstelle implementiert: <button>