HTMLButtonElement

Baseline Widely available *

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨2015年7月⁩.

* Some parts of this feature may have varying levels of support.

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

インスタンスプロパティ

親である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読取専用

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

HTMLButtonElement.validity読取専用

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

HTMLButtonElement.value

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

インスタンスメソッド

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

HTMLButtonElement.checkValidity(): この要素の値に懸賞の問題ない場合はtrue を返します。それ以外の場合はfalse を返します。
HTMLButtonElement.reportValidity(): checkValidity() と同じ処理を行いますが、invalid イベントがキャンセルされなかった場合は、ユーザーにも結果を報告します。