Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

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.

EventTarget Node Element HTMLElement HTMLButtonElement

Instanz-Eigenschaften

Erbt Eigenschaften von seinem Elternteil, HTMLElement.

HTMLButtonElement.command

Ein String-Wert, der die Aktion angibt, die an einem durch diesen Button gesteuerten Element ausgeführt werden soll.

HTMLButtonElement.commandForElement

Eine Referenz auf ein vorhandenes Element, das der Button kontrolliert.

HTMLButtonElement.disabled

Ein boolean-Wert, der anzeigt, ob das Steuerelement deaktiviert ist, was bedeutet, dass es keine Klicks akzeptiert.

HTMLButtonElement.form Schreibgeschützt

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örige HTMLFormElement des Formulars. Wenn der Button kein Nachkomme eines Formularelements ist, kann das Attribut eine Referenz auf ein HTMLFormElement-Element im gleichen Dokument sein, mit dem es in Beziehung steht, oder der null-Wert, wenn keines übereinstimmt.

HTMLButtonElement.formAction

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.

HTMLButtonElement.formEnctype

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.

HTMLButtonElement.formMethod

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.

HTMLButtonElement.formNoValidate

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.

HTMLButtonElement.formTarget

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.

HTMLButtonElement.interestForElement Experimentell

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.

HTMLButtonElement.labels Schreibgeschützt

Eine NodeList, die eine Liste von <label>-Elementen darstellt, die Labels für diesen Button sind.

HTMLButtonElement.name

Ein String, der den Namen des Objekts beim Absenden mit einem Formular repräsentiert. Wenn angegeben, darf er nicht der leere String sein.

HTMLButtonElement.popoverTargetAction

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 des popovertargetaction-HTML-Attributs wider.

HTMLButtonElement.popoverTargetElement

Ruft das "popover"-Element ab, das über einen Button gesteuert wird oder setzt es. Das JavaScript-Äquivalent des popovertarget-HTML-Attributes.

HTMLButtonElement.type

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
HTMLButtonElement.willValidate Schreibgeschützt

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: seine type-Eigenschaft ist reset oder button; er hat einen <datalist>-Vorfahren; oder die disabled-Eigenschaft ist auf true gesetzt.

HTMLButtonElement.validationMessage Schreibgeschützt

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 ist false), oder wenn sie ihre Einschränkungen erfüllt.

HTMLButtonElement.validity Schreibgeschützt

Ein ValidityState, der die Gültigkeitszustände darstellt, in denen sich dieser Button befindet.

HTMLButtonElement.value

Ein String, der den aktuellen Wert der Formularsteuerung des Buttons repräsentiert.

Instanz-Methoden

Erbt Methoden von seinem Elternteil, HTMLElement.

HTMLButtonElement.checkValidity()

Gibt true zurück, wenn der Wert des Elements keine Gültigkeitsprobleme aufweist; andernfalls false.

HTMLButtonElement.reportValidity()

Führt die gleiche Aktion wie checkValidity() aus, berichtet aber auch das Ergebnis an den Benutzer, wenn das invalid-Ereignis nicht abgebrochen wurde.

HTMLButtonElement.setCustomValidity()

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>