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.
Instanzeigenschaften
Erbt Eigenschaften von seinem Elternteil, HTMLElement
.
-
Ein Zeichenfolgenwert, der die Aktion angibt, die bei einem vom Button gesteuerten Element ausgeführt werden soll.
-
Ein Verweis auf ein vorhandenes
Element
, das vom Button gesteuert wird. -
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 verknüpft ist. Ist der Button ein Nachkomme eines Formularelements, dann ist dieses Attribut ein Verweis auf das zugehörigeHTMLFormElement
des Formulars. Wenn der Button nicht ein Nachkomme eines Formularelements ist, kann das Attribut ein Verweis auf jedesHTMLFormElement
-Element im selben Dokument sein, mit dem es verbunden ist, oder den Wertnull
haben, wenn keine Übereinstimmung vorliegt. -
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. -
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. -
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. -
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. -
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. -
Eine
NodeList
, die eine Liste von<label>
Elementen darstellt, die Labels für diesen Button sind. -
Eine Zeichenfolge, die den Namen des Objekts bei der Übermittlung mit einem Formular darstellt. Wenn angegeben, darf sie nicht die leere Zeichenfolge sein.
-
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 despopovertargetaction
HTML-Attributs wider. -
Ruft das Popover-Element ab oder setzt es, das über einen Button gesteuert werden soll. Das JavaScript-Äquivalent des
popovertarget
HTML-Attributs. -
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
-
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: seinetype
Eigenschaft istreset
oderbutton
; es hat einen<datalist>
Vorfahren; oder diedisabled
Eigenschaft ist auftrue
gesetzt. -
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
istfalse
), oder wenn es seine Einschränkungen erfüllt. -
Ein
ValidityState
, das die Gültigkeitszustände darstellt, in denen sich dieser Button befindet. -
Eine Zeichenfolge, die den aktuellen Formularsteuerwert des Buttons darstellt.
Instanzmethoden
Erbt Methoden von seinem Elternteil, HTMLElement
.
-
Gibt
true
zurück, wenn der Wert des Elements keine Gültigkeitsprobleme aufweist; andernfalls wirdfalse
zurückgegeben. -
Führt die gleiche Aktion wie
checkValidity()
aus, meldet aber das Ergebnis auch dem Benutzer, wenn dasinvalid
Ereignis nicht abgebrochen wurde. -
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>