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 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örigeHTMLFormElementdieses Formulars. Wenn der Knopf kein Nachkomme eines Formular-Elements ist, dann kann das Attribut ein Verweis auf ein beliebigesHTMLFormElementim 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
actionAttribut 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
enctypeAttribut 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
methodAttribut 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
novalidateAttribut 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
targetAttribut 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-Attributspopovertargetactionwider. -
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 istresetoderbutton; es hat einen<datalist>Vorfahren; oder diedisabledEigenschaft ist auftruegesetzt. -
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 (
willValidateistfalse), 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
truezurück, wenn der Wert des Elements keine Gültigkeitsprobleme aufweist; andernfalls gibt esfalsezurü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
Loading…
Siehe auch
- HTML-Element, das dieses Interface implementiert:
<button>