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.
Die HTMLButtonElement
-Schnittstelle bietet zusätzliche Eigenschaften und Methoden (über die reguläre HTMLElement
-Schnittstelle hinaus, die sie auch durch Vererbung zur Verfügung hat) zur Manipulation von <button>
-Elementen.
Instanz-Eigenschaften
Erbt Eigenschaften von ihrem Elternteil, HTMLElement
.
-
Ein boolescher Wert, der angibt, ob die Steuerung deaktiviert ist, was bedeutet, dass sie keine Klicks akzeptiert.
-
Ein
HTMLFormElement
, das das Formular widerspiegelt, mit dem dieser Button verbunden ist. Wenn der Button ein Nachkomme eines Formularelements ist, stellt dieses Attribut eine Referenz auf das zugehörigeHTMLFormElement
dieses Formulars dar. Wenn der Button kein Nachkomme eines Formularelements ist, kann das Attribut eine Referenz auf ein beliebigesHTMLFormElement
Element im selben Dokument sein, mit dem es verbunden ist, oder der Wertnull
, wenn keine Übereinstimmung besteht. -
Ein String, der die URI einer Ressource widerspiegelt, die die vom Button übermittelten Informationen verarbeitet. Falls angegeben, überschreibt dieses Attribut das
action
-Attribut des<form>
-Elements, dem dieses Element gehört. -
Ein String, der den Inhaltstyp widerspiegelt, der verwendet wird, um das Formular an den Server zu übermitteln. Falls angegeben, überschreibt dieses Attribut das
enctype
-Attribut des<form>
-Elements, dem dieses Element gehört. -
Ein String, der die HTTP-Methode widerspiegelt, die der Browser verwendet, um das Formular zu übermitteln. Falls angegeben, überschreibt dieses Attribut das
method
-Attribut des<form>
-Elements, dem dieses Element gehört. -
Ein boolescher Wert, der angibt, dass das Formular bei Übermittlung nicht validiert werden soll. Falls angegeben, überschreibt dieses Attribut das
novalidate
-Attribut des<form>
-Elements, dem dieses Element gehört. -
Ein String, der einen Namen oder ein Schlüsselwort widerspiegelt, das angibt, wo die Antwort angezeigt werden soll, die nach der Übermittlung des Formulars empfangen wird. Falls angegeben, überschreibt dieses Attribut das
target
-Attribut des<form>
-Elements, dem dieses Element gehört. -
Eine
NodeList
, die eine Liste von<label>
-Elementen darstellt, die Labels für diesen Button sind. -
Ein String, der den Namen des Objekts bei Übermittlung mit einem Formular darstellt. Falls angegeben, darf es nicht der leere String sein.
-
Ermittelt und setzt die Aktion, die (
"hide"
,"show"
, oder"toggle"
) an einem Popover-Element ausgeführt werden soll, das von einem Steuerbutton kontrolliert wird. Es spiegelt den Wert despopovertargetaction
-HTML-Attributs wider. -
Ermittelt und setzt das Popover-Element, das über einen Button gesteuert werden soll. Das JavaScript-Äquivalent des
popovertarget
-HTML-Attributs. -
Ein String, der das Verhalten des Buttons angibt. Dies ist ein aufgezähltes Attribut mit folgenden möglichen Werten:
submit
: Der Button übermittelt das Formular. Dies ist der Standardwert, wenn das Attribut nicht angegeben wurde oder es dynamisch auf einen leeren oder ungültigen Wert geändert wurde.reset
: Der Button setzt das Formular zurück.button
: Der Button führt keine Aktion durch.menu
: Der Button zeigt ein Menü an. Experimentell
-
Ein boolescher Wert, der angibt, ob der Button ein Kandidat für die Validierung von Einschränkungen ist. Er ist
false
, wenn Bedingungen die Einschränkungsvalidierung ausschließen, einschließlich: seinetype
-Eigenschaft istreset
oderbutton
; er hat einen<datalist>
-Vorfahr; oder diedisabled
-Eigenschaft ist auftrue
gesetzt. -
Ein String, der die lokalisierte Nachricht darstellt, die die Validierungseinschränkungen beschreibt, die die Steuerung nicht erfüllt (falls vorhanden). Dieses Attribut ist der leere String, wenn die Steuerung kein Kandidat für die Einschränkungsvalidierung ist (
willValidate
istfalse
) oder sie ihre Einschränkungen erfüllt. -
Ein
ValidityState
, der die Gültigkeitszustände darstellt, in denen sich dieser Button befindet. -
Ein String, der den aktuellen Wert der Formularsteuerung des Buttons darstellt.
Instanz-Methoden
Erbt Methoden von ihrem Elternteil, HTMLElement
.
-
Gibt
true
zurück, wenn der Wert des Elements keine Gültigkeitsprobleme aufweist; andernfalls gibt esfalse
zurück. -
Führt die gleiche Aktion wie
checkValidity()
aus, meldet aber auch das Ergebnis dem Benutzer, wenn dasinvalid
-Ereignis nicht abgebrochen wurde.
Spezifikationen
Specification |
---|
HTML Standard # htmlbuttonelement |
Browser-Kompatibilität
BCD tables only load in the browser
Siehe auch
- HTML-Element, das diese Schnittstelle implementiert:
<button>