HTMLButtonElement
Baseline
Widely available
*
This feature is well established and works across many devices and browser versions. It’s been available across browsers since Juli 2015.
* Some parts of this feature may have varying levels of support.
Das HTMLButtonElement-Interface bietet Eigenschaften und Methoden (zusätzlich zu denen des regulären HTMLElement-Interfaces, die ihm durch Vererbung ebenfalls zur Verfügung stehen) zur Manipulation von <button>-Elementen.
Instanz-Eigenschaften
Erbt Eigenschaften von seinem Elternteil, HTMLElement.
-
Ein String-Wert, der die Aktion angibt, die an einem durch diesen Button gesteuerten Element ausgeführt werden soll.
-
Eine Referenz auf ein vorhandenes
Element, das der Button kontrolliert. -
Ein boolean-Wert, der anzeigt, ob das Steuerelement deaktiviert ist, was bedeutet, dass es keine Klicks akzeptiert.
-
Ein
HTMLFormElement, das das Formular widerspiegelt, mit dem dieser Button verknüpft ist. Wenn der Button ein Nachkomme eines Formularelements ist, ist dieses Attribut eine Referenz auf das zugehörigeHTMLFormElementdes Formulars. Wenn der Button kein Nachkomme eines Formularelements ist, kann das Attribut eine Referenz auf einHTMLFormElement-Element im gleichen Dokument sein, mit dem es in Beziehung steht, oder dernull-Wert, wenn keines übereinstimmt. -
Ein String, der die URI einer Ressource widerspiegelt, die Informationen verarbeitet, die vom Button übermittelt werden. Wenn angegeben, überschreibt dieses Attribut das
action-Attribut des<form>-Elements, das dieses Element besitzt. -
Ein String, der den Typ des Inhalts widerspiegelt, der zum Übermitteln des Formulars an den Server verwendet wird. Wenn angegeben, überschreibt dieses Attribut das
enctype-Attribut des<form>-Elements, das dieses Element besitzt. -
Ein String, der die HTTP-Methode widerspiegelt, die der Browser zur Übermittlung des Formulars verwendet. Wenn angegeben, überschreibt dieses Attribut das
method-Attribut des<form>-Elements, das dieses Element besitzt. -
Ein boolean-Wert, der angibt, dass das Formular beim Absenden nicht validiert werden soll. Wenn angegeben, überschreibt dieses Attribut das
novalidate-Attribut des<form>-Elements, das dieses Element besitzt. -
Ein String, der einen Namen oder ein Schlüsselwort widerspiegelt, welcher angibt, wo die Antwort angezeigt wird, die nach dem Absenden des Formulars empfangen wurde. Wenn angegeben, überschreibt dieses Attribut das
target-Attribut des<form>-Elements, das dieses Element besitzt. -
Ruft das Ziel-Element eines "interest invoker" ab oder setzt es in Fällen, in denen das zugehörige
<button>-Element als Interest Invoker angegeben ist. -
Eine
NodeList, die eine Liste von<label>-Elementen darstellt, die Labels für diesen Button sind. -
Ein String, der den Namen des Objekts beim Absenden mit einem Formular repräsentiert. Wenn angegeben, darf er nicht der leere String sein.
-
Ruft die Aktion ab oder setzt sie, die (
"hide","show"oder"toggle") auf einem "popover"-Element durchgeführt werden soll, das von einem Steuerungsbutton gesteuert wird. Es spiegelt den Wert despopovertargetaction-HTML-Attributs wider. -
Ruft das "popover"-Element ab, das über einen Button gesteuert wird oder setzt es. Das JavaScript-Äquivalent des
popovertarget-HTML-Attributes. -
Ein String, der 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 wenn es dynamisch in einen leeren oder ungültigen Wert geändert wurde.reset: Der Button setzt das Formular zurück.button: Der Button führt keine Aktion aus.menu: Der Button zeigt ein Menü an. Experimentell
-
Ein boolean-Wert, der angibt, ob der Button für die Einschränkungsvalidierung in Frage kommt. Es ist
false, wenn irgendwelche Bedingungen ihn von der Einschränkungsvalidierung ausschließen, einschließlich: seinetype-Eigenschaft istresetoderbutton; er hat einen<datalist>-Vorfahren; oder diedisabled-Eigenschaft ist auftruegesetzt. -
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 (
willValidateistfalse), oder wenn 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 repräsentiert.
Instanz-Methoden
Erbt Methoden von seinem Elternteil, HTMLElement.
-
Gibt
truezurück, wenn der Wert des Elements keine Gültigkeitsprobleme aufweist; andernfallsfalse. -
Führt die gleiche Aktion wie
checkValidity()aus, berichtet aber auch das Ergebnis an den Benutzer, wenn dasinvalid-Ereignis nicht abgebrochen wurde. -
Setzt die benutzerdefinierte Gültigkeitsnachricht für das Element. Verwenden Sie den leeren String, um anzuzeigen, dass das Element keinen benutzerdefinierten Gültigkeitsfehler aufweist.
Spezifikationen
| Specification |
|---|
| HTML> # htmlbuttonelement> |
Browser-Kompatibilität
Siehe auch
- HTML-Element, das diese Schnittstelle implementiert:
<button>