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.

HTMLButtonElement インターフェイスは、(通常の HTMLElement から継承によって利用できるものに加えて)<button> 要素を操作するためのプロパティやメソッドを提供します。

EventTarget Node Element HTMLElement HTMLButtonElement

インスタンスプロパティ

親である HTMLElement から継承したプロパティもあります。

HTMLButtonElement.disabled

論理値で、コントロールが無効か否か、つまりクリックを受け付けるかどうかを示します。

HTMLButtonElement.form 読取専用

HTMLFormElement で、このボタンが関連付けられているフォームを反映します。ボタンがフォームの子孫要素である場合は、この属性は関連付けられた HTMLFormElement への参照になります。 ボタンがフォーム要素の子孫でない場合は、属性は同じ文書内にある任意の HTMLFormElement への参照になる可能性があり、また一致するものがなければ null 値になります。

HTMLButtonElement.formAction

文字列で、ボタンによって送信された情報を処理するリソースの URI を反映します。指定された場合は、この属性はこの要素のオーナーである <form> 要素の action 属性を上書きします。

HTMLButtonElement.formEnctype

文字列で、サーバーにフォームを送信するために使用されるコンテンツの型を反映します。指定された場合は、この属性はこの要素のオーナーである <form> 要素の enctype 属性を上書きします。

HTMLButtonElement.formMethod

文字列で、ブラウザーがフォームを送信するために使用する HTTP メソッドを反映します。指定された場合は、この属性はこの要素のオーナーである <form> 要素の method 属性を上書きします。

HTMLButtonElement.formNoValidate

論理値で、フォームの送信時に値の検証が行われないことを示します。指定された場合は、この属性はこの要素のオーナーである <form> 要素の novalidate 属性を上書きします。

HTMLButtonElement.formTarget

文字列で、フォームに送信した後で受信するレスポンスを表示する場所を示す名前またはキーワードを反映します。指定された場合は、この属性はこの要素のオーナーである <form> 要素の target 属性を上書きします。

HTMLButtonElement.labels 読取専用

NodeList で、このボタンのラベルとなる <label> 要素を表します。

HTMLButtonElement.name

文字列で、フォームを送信したときのオブジェクトの名前を表します。指定された場合は、空文字列にすることはできません。

HTMLButtonElement.popoverTargetAction

制御ボタンで制御されるポップオーバー要素で実行されるアクション("hide""show""toggle" の何れか)を取得および設定します。これは HTML の popovertargetaction 属性の値を反映します。

HTMLButtonElement.popoverTargetElement

ボタンで制御するポップオーバー要素を取得および設定します。JavaScript において HTML の popovertarget 属性と同等のものです。

HTMLButtonElement.type

文字列で、このボタンの動作を示します。これは列挙型属性で、以下の値を取ることができます。

  • submit: フォームを送信するボタンです。これは属性が指定されていなかった場合の既定値です。または空の値や無効な値に変更された場合の既定値です。
  • reset: フォームをリセットするボタンです。
  • button: 何もしないボタンです。
  • menu: メニューを表示するボタンです。 Experimental
HTMLButtonElement.willValidate 読取専用

論理値で、ボタンが制約検証の候補になるかどうかを示します。制約検証が阻止される場合は false となり、これには type プロパティが reset または button である場合、祖先に <datalist> がある場合、 disabled プロパティが true に設定されている場合が含まれます。

HTMLButtonElement.validationMessage 読取専用

文字列で、(もしあれば)制約検証でコントロールが合格しなかった場合のローカライズされたメッセージを表現します。この属性はコントロールが制約検証の候補にならない場合(willValidatefalse の場合)や、制約を満たしている場合は空文字列になります。

HTMLButtonElement.validity 読取専用

ValidityState で、このボタンがある妥当性の状態を表します。

HTMLButtonElement.value

文字列で、ボタンの現在のフォームコントロールの値を表します。

インスタンスメソッド

親である HTMLElement から継承したメソッドもあります

HTMLButtonElement.checkValidity()

この要素の値に懸賞の問題ない場合は true を返します。それ以外の場合は false を返します。

HTMLButtonElement.reportValidity()

checkValidity() と同じ処理を行いますが、 invalid イベントがキャンセルされなかった場合は、ユーザーにも結果を報告します。

仕様書

Specification
HTML
# htmlbuttonelement

ブラウザーの互換性

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
HTMLButtonElement
checkValidity
command
Experimental
commandForElement
Experimental
disabled
form
formAction
formEnctype
formMethod
formNoValidate
formTarget
labels
name
popoverTargetAction
popoverTargetElement
Implicit anchor reference via popoverTargetElement
Experimental
reportValidity
setCustomValidity
type
validationMessage
validity
value
willValidate

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
In development. Supported in a pre-release version.
In development. Supported in a pre-release version.
No support
No support
Experimental. Expect behavior to change in the future.
See implementation notes.
User must explicitly enable this feature.

関連情報

  • このインターフェイスを実装している HTML 要素: <button>