このページはコミュニティーの尽力で英語から翻訳されました。MDN Web Docs コミュニティーについてもっと知り、仲間になるにはこちらから。
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読取専用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イベントがキャンセルされなかった場合は、ユーザーにも結果を報告します。
仕様書
| Specification |
|---|
| HTML> # htmlbuttonelement> |
ブラウザーの互換性
関連情報
- このインターフェイスを実装している HTML 要素:
<button>
