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 bietet Eigenschaften und Methoden (zusätzlich zu dem normalen HTMLElement
Interface, das es ebenfalls von der Vererbung her zur Verfügung hat) zum Manipulieren von <button>
-Elementen.
Instanzeigenschaften
Erbt Eigenschaften von seinem Elternteil, HTMLElement
.
-
Ein Zeichenfolgewert, der die Aktion angibt, die an einem durch diesen Knopf gesteuerten Element ausgeführt werden soll.
-
Ein Verweis auf ein existierendes
Element
, das durch den Knopf gesteuert wird. -
Ein boolescher Wert, der angibt, ob die Steuerung deaktiviert ist, was bedeutet, dass sie keine Klicks annimmt.
-
Ein
HTMLFormElement
, das das Formular darstellt, mit dem dieser Knopf verknüpft ist. Wenn der Knopf ein Nachkomme eines Formular-Elements ist, dann ist dieses Attribut eine Referenz auf das zugehörigeHTMLFormElement
dieses Formulars. Wenn der Knopf kein Nachkomme eines Formular-Elements ist, dann kann das Attribut ein Verweis auf ein beliebigesHTMLFormElement
im selben Dokument sein, mit dem es verknüpft ist, oder der Wertnull
, wenn kein entsprechendes vorhanden ist. -
Eine Zeichenfolge, die die URI einer Ressource darstellt, die die vom Knopf übermittelten Informationen verarbeitet. Wenn angegeben, überschreibt dieses Attribut das
action
Attribut des<form>
Elements, zu dem es gehört. -
Eine Zeichenfolge, die den Inhaltstyp darstellt, der verwendet wird, um das Formular an den Server zu übermitteln. Wenn angegeben, überschreibt dieses Attribut das
enctype
Attribut des<form>
Elements, zu dem es gehört. -
Eine Zeichenfolge, die die HTTP-Methode darstellt, die der Browser verwendet, um das Formular zu übermitteln. Wenn angegeben, überschreibt dieses Attribut das
method
Attribut des<form>
Elements, zu dem es gehört. -
Ein boolescher Wert, der angibt, dass das Formular beim Senden nicht validiert werden soll. Wenn angegeben, überschreibt dieses Attribut das
novalidate
Attribut des<form>
Elements, zu dem es gehört. -
Eine Zeichenfolge, die einen Namen oder ein Schlüsselwort darstellt, das angibt, wo die Antwort angezeigt werden soll, die nach dem Absenden des Formulars erhalten wird. Wenn angegeben, überschreibt dieses Attribut das
target
Attribut des<form>
Elements, zu dem es gehört. -
Ein
NodeList
, das eine Liste von<label>
-Elementen darstellt, die Labels für diesen Knopf sind. -
Eine Zeichenfolge, die den Namen des Objekts darstellt, wenn es mit einem Formular übermittelt wird. Wenn angegeben, darf es nicht die leere Zeichenfolge sein.
-
Ruft die Aktion ab und setzt sie (
"hide"
,"show"
oder"toggle"
), die an einem durch einen Steuerknopf kontrollierten Popover-Element ausgeführt werden soll. Es spiegelt den Wert des HTML-Attributspopovertargetaction
wider. -
Ruft das Popover-Element ab und setzt es, das über einen Knopf gesteuert werden soll. Das JavaScript-Äquivalent des HTML-Attributs
popovertarget
. -
Eine Zeichenfolge, die das Verhalten des Knopfes anzeigt. Dies ist ein enumeriertes Attribut mit den folgenden möglichen Werten:
submit
: Der Knopf übermittelt das Formular. Dies ist der Standardwert, wenn das Attribut nicht angegeben oder dynamisch auf einen leeren oder ungültigen Wert geändert wird.reset
: Der Knopf setzt das Formular zurück.button
: Der Knopf tut nichts.menu
: Der Knopf zeigt ein Menü an. Experimentell
-
Ein boolescher Wert, der angibt, ob der Knopf ein Kandidat für die Einschränkungsvalidierung ist. Er ist
false
, wenn Bedingungen es von der Einschränkungsvalidierung ausschließen, einschließlich: seinetype
-Eigenschaft istreset
oderbutton
; es hat einen<datalist>
Vorfahren; oder diedisabled
Eigenschaft ist auftrue
gesetzt. -
Eine Zeichenkette, die die lokalisierten Nachricht darstellt, welche die Validierungsbedingungen beschreibt, die die Steuerung nicht erfüllt (falls vorhanden). Dieses Attribut ist die leere Zeichenkette, wenn die Steuerung kein Kandidat für die Einschränkungsvalidierung ist (
willValidate
istfalse
), oder wenn sie ihre Einschränkungen erfüllt. -
Ein
ValidityState
, das die Gültigkeitszustände darstellt, in denen sich dieser Knopf befindet. -
Eine Zeichenfolge, die den aktuellen Formularsteuerwert des Knopfes darstellt.
Instanzmethoden
Erbt Methoden von seinem 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, aber berichtet das Ergebnis auch dem Benutzer, wenn dasinvalid
-Ereignis nicht abgebrochen wurde. -
Setzt die benutzerdefinierte Gültigkeitsnachricht 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 dieses Interface implementiert:
<button>