HTMLButtonElement

HTMLButtonElement インターフェイスは、 (HTMLElement から継承したものより詳細に) <button> 要素を操作するためのプロパティやメソッドを提供します。

プロパティ

親である HTMLElement からプロパティを継承しています。

HTMLButtonElement.accessKey
DOMString で、ボタンにアクセスするためのキーボードの1文字のキーを示します。
HTMLButtonElement.autofocus
Boolean で、ページが読み込みの際、ユーザーが異なるコントロールに入力するなどで上書きをしない限り、コントロールが入力フォーカスを持つべきかどうかを示します。文書中のフォーム関連要素の中で、この属性を指定できるのは1つだけです。
HTMLButtonElement.disabled
Boolean で、コントロールが無効か否か、つまりクリックを受け付けるかどうかを示します。
HTMLButtonElement.form 読取専用
HTMLFormElement で、このボタンが関連付けられているフォームを反映します。ボタンがフォームの子孫要素である場合は、この属性はフォーム要素の ID になります。
ボタンがフォーム要素の子孫でない場合は、属性は同じ文書内の任意のフォーム要素の ID になる可能性があり、また一致するものがなければ null 値になります。
HTMLButtonElement.formAction
DOMString で、ボタンによって送信された情報を処理するリソースの URI を反映します。指定された場合は、この属性はこの要素のオーナーである <form> 要素の action 属性を上書きします。
HTMLButtonElement.formEnctype
DOMString で、サーバーにフォームを送信するために使用されるコンテンツの型を反映します。指定された場合は、この属性はこの要素のオーナーである <form> 要素の enctype 属性を上書きします。
HTMLButtonElement.formMethod
DOMString で、ブラウザーがフォームを送信するために使用する HTTP メソッドを反映します。指定された場合は、この属性はこの要素のオーナーである <form> 要素の method 属性を上書きします。
HTMLButtonElement.formNoValidate
Boolean で、フォームの送信時に値の検証が行われないことを示します。指定された場合は、この属性はこの要素のオーナーである <form> 要素の novalidate 属性を上書きします。
HTMLButtonElement.formTarget
DOMString で、フォームに送信した後で受信するレスポンスを表示する場所を示す名前またはキーワードを反映します。指定された場合は、この属性はこの要素のオーナーである <form> 要素の target 属性を上書きします。
HTMLButtonElement.labels 読取専用
NodeList で、このボタンのラベルとなる <label> 要素を表します。
HTMLButtonElement.menu
HTMLMenuElement で、ボタンが type="menu" である場合にクリックした場合に表示されるメニュー要素を表します。
HTMLButtonElement.name
DOMString で、フォームを送信したときのオブジェクトの名前を表します。 HTML5 指定された場合は、空文字列にすることはできません。
HTMLButtonElement.tabIndex
long で、タブ順でのこの要素の位置を表します。
HTMLButtonElement.type
DOMString で、このボタンの動作を示します。これは列挙型属性で、以下の値を取ることができます。
  • submit: フォームを送信するボタンです。これは属性が指定されていなかった場合の既定値です。 HTML5 または空の値や無効な値に変更された場合の既定値です。
  • reset: フォームをリセットするボタンです。
  • button: 何もしないボタンです。
  • menu: メニューを表示するボタンです。
HTMLButtonElement.willValidate 読取専用
Boolean で、ボタンが制約検証の候補になるかどうかを示します。制約検証が阻止される場合は false となり、これには type プロパティが reset または button である場合、祖先に <datalist> がある場合、 disabled プロパティが true に設定されている場合が含まれます。
HTMLButtonElement.validationMessage 読取専用
DOMString で、 (もしあれば) 制約検証でコントロールが合格しなかった場合のローカライズされたメッセージを表現します。この属性はコントロールが制約検証の候補にならない場合 (willValidatefalse の場合) や、制約を満たしている場合は空文字列になります。
HTMLButtonElement.validity 読取専用
ValidityState で、このボタンがある妥当性の状態を表します。
HTMLButtonElement.value
DOMString で、ボタンの現在のフォームコントロールの値を表します。

メソッド

親である HTMLElement からメソッドを継承しています。

名称 返却型 説明
checkValidity() Boolean リセットまたはボタン要素は対応していません。
reportValidity() Boolean リセットまたはボタン要素は対応していません。
setCustomValidity(in DOMString error) void リセットまたはボタン要素は対応していません。

Gecko を基盤としたブラウザーでは、 :-moz-submit-invalid 擬似クラスを用いてフォームの妥当性に基いた送信ボタンの装飾をすることができます。

仕様書

仕様書 状態 備考
HTML Living Standard
HTMLButtonElement の定義
現行の標準
HTML 5.2
HTMLButtonElement の定義
勧告 menu 属性および type="menu" 値が削除された。
HTML 5.1
HTMLButtonElement の定義
勧告 menu 属性が追加された。
type 属性でもう一つ、 "menu" の値が取れるようになった。
HTML5
HTMLButtonElement の定義
勧告 tabindex および accesskey 属性が HTMLElement で定義されるようになった。
autofocus, formAction, formEnctype, formMethod, formNoValidate, formTarget, labels, validity, validationMessage, willValidate 属性が追加された。
checkValidity(), setCustomValidity() メソッドが追加された。
type 属性が読取専用ではなくなった。
Document Object Model (DOM) Level 2 HTML Specification
HTMLButtonElement の定義
廃止された Document Object Model (DOM) Level 1 Specification から変更なし
Document Object Model (DOM) Level 1 Specification
HTMLButtonElement の定義
廃止された 初回定義

ブラウザーの互換性

Update compatibility data on GitHub
デスクトップモバイル
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewAndroid 版 ChromeAndroid 版 FirefoxAndroid 版 OperaiOSのSafariSamsung Internet
HTMLButtonElementChrome 完全対応 ありEdge 完全対応 12Firefox 完全対応 1IE 完全対応 ありOpera 完全対応 ありSafari 完全対応 ありWebView Android 完全対応 ありChrome Android 完全対応 ありFirefox Android 完全対応 4Opera Android 完全対応 ありSafari iOS 完全対応 ありSamsung Internet Android 完全対応 あり
accessKeyChrome 完全対応 ありEdge 完全対応 12Firefox 完全対応 1IE 完全対応 ありOpera 完全対応 ありSafari 完全対応 ありWebView Android 完全対応 ありChrome Android 完全対応 ありFirefox Android 完全対応 4Opera Android 完全対応 ありSafari iOS 完全対応 ありSamsung Internet Android 完全対応 あり
autofocusChrome 完全対応 ありEdge 完全対応 12Firefox 完全対応 1IE 完全対応 ありOpera 完全対応 ありSafari 完全対応 ありWebView Android 完全対応 ありChrome Android 完全対応 ありFirefox Android 完全対応 4Opera Android 完全対応 ありSafari iOS 完全対応 ありSamsung Internet Android 完全対応 あり
disabledChrome 完全対応 ありEdge 完全対応 12Firefox 完全対応 1IE 完全対応 ありOpera 完全対応 ありSafari 完全対応 ありWebView Android 完全対応 ありChrome Android 完全対応 ありFirefox Android 完全対応 4Opera Android 完全対応 ありSafari iOS 完全対応 ありSamsung Internet Android 完全対応 あり
formChrome 完全対応 ありEdge 完全対応 16Firefox 完全対応 4IE 未対応 なしOpera 完全対応 ありSafari 完全対応 ありWebView Android 完全対応 ありChrome Android 完全対応 ありFirefox Android 完全対応 4Opera Android 完全対応 ありSafari iOS 完全対応 ありSamsung Internet Android 完全対応 あり
formActionChrome 完全対応 ありEdge 完全対応 12Firefox 完全対応 4
補足
完全対応 4
補足
補足 In Firefox 56, the implementation has been updated so that the formAction property returns the correct form submission URL, as per spec, when the associated button is being used to submit a form (bug 1366361).
IE 完全対応 ありOpera 完全対応 ありSafari 完全対応 ありWebView Android 完全対応 ありChrome Android 完全対応 ありFirefox Android 完全対応 4
補足
完全対応 4
補足
補足 In Firefox 56, the implementation has been updated so that the formAction property returns the correct form submission URL, as per spec, when the associated button is being used to submit a form (bug 1366361).
Opera Android 完全対応 ありSafari iOS 完全対応 ありSamsung Internet Android 完全対応 あり
formEnctypeChrome 完全対応 ありEdge 完全対応 12Firefox 完全対応 4IE 完全対応 ありOpera 完全対応 ありSafari 完全対応 ありWebView Android 完全対応 ありChrome Android 完全対応 ありFirefox Android 完全対応 4Opera Android 完全対応 ありSafari iOS 完全対応 ありSamsung Internet Android 完全対応 あり
formMethodChrome 完全対応 ありEdge 完全対応 12Firefox 完全対応 4IE 完全対応 ありOpera 完全対応 ありSafari 完全対応 ありWebView Android 完全対応 ありChrome Android 完全対応 ありFirefox Android 完全対応 4Opera Android 完全対応 ありSafari iOS 完全対応 ありSamsung Internet Android 完全対応 あり
formNoValidateChrome 完全対応 ありEdge 完全対応 12Firefox 完全対応 4IE 完全対応 ありOpera 完全対応 ありSafari 完全対応 ありWebView Android 完全対応 ありChrome Android 完全対応 ありFirefox Android 完全対応 4Opera Android 完全対応 ありSafari iOS 完全対応 ありSamsung Internet Android 完全対応 あり
formTargetChrome 完全対応 ありEdge 完全対応 12Firefox 完全対応 4IE 完全対応 ありOpera 完全対応 ありSafari 完全対応 ありWebView Android 完全対応 ありChrome Android 完全対応 ありFirefox Android 完全対応 4Opera Android 完全対応 ありSafari iOS 完全対応 ありSamsung Internet Android 完全対応 あり
labelsChrome 完全対応 ありEdge 完全対応 18Firefox 完全対応 56IE 未対応 なしOpera 完全対応 ありSafari 完全対応 ありWebView Android 完全対応 ありChrome Android 完全対応 ありFirefox Android 完全対応 56Opera Android 完全対応 ありSafari iOS 完全対応 ありSamsung Internet Android 完全対応 あり
menu
実験的
Chrome 未対応 なしEdge 未対応 なしFirefox 未対応 なしIE 未対応 なしOpera 未対応 なしSafari 未対応 なしWebView Android 未対応 なしChrome Android 未対応 なしFirefox Android 未対応 なしOpera Android 未対応 なしSafari iOS 未対応 なしSamsung Internet Android 未対応 なし
nameChrome 完全対応 ありEdge 完全対応 12Firefox 完全対応 1IE 完全対応 ありOpera 完全対応 ありSafari 完全対応 ありWebView Android 完全対応 ありChrome Android 完全対応 ありFirefox Android 完全対応 4Opera Android 完全対応 ありSafari iOS 完全対応 ありSamsung Internet Android 完全対応 あり
reportValidityChrome 完全対応 40Edge 完全対応 17Firefox 完全対応 49IE 未対応 なしOpera 完全対応 27Safari 完全対応 10WebView Android 完全対応 40Chrome Android 完全対応 40Firefox Android 完全対応 64Opera Android 完全対応 27Safari iOS 完全対応 10Samsung Internet Android 完全対応 4.0
tabIndexChrome 完全対応 ありEdge 完全対応 12Firefox 完全対応 1IE 完全対応 ありOpera 完全対応 ありSafari 完全対応 ありWebView Android 完全対応 ありChrome Android 完全対応 ありFirefox Android 完全対応 4Opera Android 完全対応 ありSafari iOS 完全対応 ありSamsung Internet Android 完全対応 あり
typeChrome 完全対応 ありEdge 完全対応 12Firefox 完全対応 1IE 完全対応 ありOpera 完全対応 ありSafari 完全対応 ありWebView Android 完全対応 ありChrome Android 完全対応 ありFirefox Android 完全対応 4Opera Android 完全対応 ありSafari iOS 完全対応 ありSamsung Internet Android 完全対応 あり
validationMessageChrome 完全対応 ありEdge 完全対応 12Firefox 完全対応 1IE 完全対応 ありOpera 完全対応 ありSafari 完全対応 ありWebView Android 完全対応 ありChrome Android 完全対応 ありFirefox Android 完全対応 4Opera Android 完全対応 ありSafari iOS 完全対応 ありSamsung Internet Android 完全対応 あり
validityChrome 完全対応 ありEdge 完全対応 12Firefox 完全対応 1IE 完全対応 ありOpera 完全対応 ありSafari 完全対応 ありWebView Android 完全対応 ありChrome Android 完全対応 ありFirefox Android 完全対応 4Opera Android 完全対応 ありSafari iOS 完全対応 ありSamsung Internet Android 完全対応 あり
valueChrome 完全対応 ありEdge 完全対応 12Firefox 完全対応 1IE 完全対応 ありOpera 完全対応 ありSafari 完全対応 ありWebView Android 完全対応 ありChrome Android 完全対応 ありFirefox Android 完全対応 4Opera Android 完全対応 ありSafari iOS 完全対応 ありSamsung Internet Android 完全対応 あり
willValidateChrome 完全対応 ありEdge 完全対応 12Firefox 完全対応 1IE 完全対応 ありOpera 完全対応 ありSafari 完全対応 ありWebView Android 完全対応 ありChrome Android 完全対応 ありFirefox Android 完全対応 4Opera Android 完全対応 ありSafari iOS 完全対応 ありSamsung Internet Android 完全対応 あり

凡例

完全対応  
完全対応
未対応  
未対応
実験的。動作が変更される可能性があります。
実験的。動作が変更される可能性があります。
実装ノートを参照してください。
実装ノートを参照してください。

関連情報

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