HTMLButtonElement インターフェイスは、 (HTMLElement から継承したものより詳細に) <button> 要素を操作するためのプロパティやメソッドを提供します。
<div id="interfaceDiagram" style="display: inline-block; position: relative; width: 100%; padding-bottom: 20%; vertical-align: middle; overflow: hidden;"><svg style="display: inline-block; position: absolute; top: 0; left: 0;" viewbox="-50 0 600 120" preserveAspectRatio="xMinYMin meet"><a xlink:href="https://developer.mozilla.org/ja/docs/Web/API/EventTarget" target="_top"><rect x="1" y="1" width="110" height="50" fill="#fff" stroke="#D4DDE4" stroke-width="2px" /><text x="56" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">EventTarget</text></a><polyline points="111,25 121,20 121,30 111,25" stroke="#D4DDE4" fill="none"/><line x1="121" y1="25" x2="151" y2="25" stroke="#D4DDE4"/><a xlink:href="https://developer.mozilla.org/ja/docs/Web/API/Node" target="_top"><rect x="151" y="1" width="75" height="50" fill="#fff" stroke="#D4DDE4" stroke-width="2px" /><text x="188.5" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">Node</text></a><polyline points="226,25 236,20 236,30 226,25" stroke="#D4DDE4" fill="none"/><line x1="236" y1="25" x2="266" y2="25" stroke="#D4DDE4"/><a xlink:href="https://developer.mozilla.org/ja/docs/Web/API/Element" target="_top"><rect x="266" y="1" width="75" height="50" fill="#fff" stroke="#D4DDE4" stroke-width="2px" /><text x="303.5" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">Element</text></a><polyline points="341,25 351,20 351,30 341,25" stroke="#D4DDE4" fill="none"/><line x1="351" y1="25" x2="381" y2="25" stroke="#D4DDE4"/><a xlink:href="https://developer.mozilla.org/ja/docs/Web/API/HTMLElement" target="_top"><rect x="381" y="1" width="110" height="50" fill="#fff" stroke="#D4DDE4" stroke-width="2px" /><text x="436" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">HTMLElement</text></a><polyline points="491,25 501,20 501,30 491,25" stroke="#D4DDE4" fill="none"/><line x1="501" y1="25" x2="509" y2="25" stroke="#D4DDE4"/><line x1="509" y1="25" x2="509" y2="90" stroke="#D4DDE4"/><line x1="509" y1="90" x2="492" y2="90" stroke="#D4DDE4"/><a xlink:href="https://developer.mozilla.org/ja/docs/Web/API/HTMLButtonElement" target="_top"><rect x="321" y="65" width="170" height="50" fill="#F4F7F8" stroke="#D4DDE4" stroke-width="2px" /><text x="406" y="94" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">HTMLButtonElement</text></a></svg></div>
a:hover text { fill: #0095DD; pointer-events: all;}
プロパティ
親である HTMLElement からプロパティを継承しています。
HTMLButtonElement.accessKeyDOMStringで、ボタンにアクセスするためのキーボードの1文字のキーを示します。HTMLButtonElement.autofocusBooleanで、ページが読み込みの際、ユーザーが異なるコントロールに入力するなどで上書きをしない限り、コントロールが入力フォーカスを持つべきかどうかを示します。文書中のフォーム関連要素の中で、この属性を指定できるのは1つだけです。HTMLButtonElement.disabledBooleanで、コントロールが無効か否か、つまりクリックを受け付けるかどうかを示します。HTMLButtonElement.form読取専用HTMLFormElementで、このボタンが関連付けられているフォームを反映します。ボタンがフォームの子孫要素である場合は、この属性はフォーム要素の ID になります。
ボタンがフォーム要素の子孫でない場合は、属性は同じ文書内の任意のフォーム要素の ID になる可能性があり、また一致するものがなければnull値になります。HTMLButtonElement.formActionDOMStringで、ボタンによって送信された情報を処理するリソースの URI を反映します。指定された場合は、この属性はこの要素のオーナーである<form>要素のaction属性を上書きします。HTMLButtonElement.formEnctypeDOMStringで、サーバーにフォームを送信するために使用されるコンテンツの型を反映します。指定された場合は、この属性はこの要素のオーナーである<form>要素のenctype属性を上書きします。HTMLButtonElement.formMethodDOMStringで、ブラウザーがフォームを送信するために使用する HTTP メソッドを反映します。指定された場合は、この属性はこの要素のオーナーである<form>要素のmethod属性を上書きします。HTMLButtonElement.formNoValidateBooleanで、フォームの送信時に値の検証が行われないことを示します。指定された場合は、この属性はこの要素のオーナーである<form>要素のnovalidate属性を上書きします。HTMLButtonElement.formTargetDOMStringで、フォームに送信した後で受信するレスポンスを表示する場所を示す名前またはキーワードを反映します。指定された場合は、この属性はこの要素のオーナーである<form>要素のtarget属性を上書きします。HTMLButtonElement.labels読取専用NodeListで、このボタンのラベルとなる<label>要素を表します。HTMLButtonElement.menuHTMLMenuElementで、ボタンがtype="menu"である場合にクリックした場合に表示されるメニュー要素を表します。HTMLButtonElement.nameDOMStringで、フォームを送信したときのオブジェクトの名前を表します。 HTML5 指定された場合は、空文字列にすることはできません。HTMLButtonElement.tabIndexlongで、タブ順でのこの要素の位置を表します。HTMLButtonElement.typeDOMStringで、このボタンの動作を示します。これは列挙型属性で、以下の値を取ることができます。submit: フォームを送信するボタンです。これは属性が指定されていなかった場合の既定値です。 HTML5 または空の値や無効な値に変更された場合の既定値です。reset: フォームをリセットするボタンです。button: 何もしないボタンです。menu: メニューを表示するボタンです。
HTMLButtonElement.willValidate読取専用Booleanで、ボタンが制約検証の候補になるかどうかを示します。制約検証が阻止される場合はfalseとなり、これにはtypeプロパティがresetまたはbuttonである場合、祖先に<datalist>がある場合、disabledプロパティがtrueに設定されている場合が含まれます。HTMLButtonElement.validationMessage読取専用DOMStringで、 (もしあれば) 制約検証でコントロールが合格しなかった場合のローカライズされたメッセージを表現します。この属性はコントロールが制約検証の候補にならない場合 (willValidateがfalseの場合) や、制約を満たしている場合は空文字列になります。HTMLButtonElement.validity読取専用ValidityStateで、このボタンがある妥当性の状態を表します。HTMLButtonElement.valueDOMStringで、ボタンの現在のフォームコントロールの値を表します。
メソッド
親である 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 の定義 |
廃止された | 初回定義 |
ブラウザーの互換性
このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 https://github.com/mdn/browser-compat-data をチェックアウトしてプルリクエストを送信してください。
Update compatibility data on GitHub
| デスクトップ | モバイル | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
HTMLButtonElement | Chrome 完全対応 あり | Edge 完全対応 12 | Firefox 完全対応 1 | IE 完全対応 あり | Opera 完全対応 あり | Safari 完全対応 あり | WebView Android 完全対応 あり | Chrome Android 完全対応 あり | Firefox Android 完全対応 4 | Opera Android 完全対応 あり | Safari iOS 完全対応 あり | Samsung Internet Android 完全対応 あり |
accessKey | Chrome 完全対応 あり | Edge 完全対応 12 | Firefox 完全対応 1 | IE 完全対応 あり | Opera 完全対応 あり | Safari 完全対応 あり | WebView Android 完全対応 あり | Chrome Android 完全対応 あり | Firefox Android 完全対応 4 | Opera Android 完全対応 あり | Safari iOS 完全対応 あり | Samsung Internet Android 完全対応 あり |
autofocus | Chrome 完全対応 あり | Edge 完全対応 12 | Firefox 完全対応 1 | IE 完全対応 あり | Opera 完全対応 あり | Safari 完全対応 あり | WebView Android 完全対応 あり | Chrome Android 完全対応 あり | Firefox Android 完全対応 4 | Opera Android 完全対応 あり | Safari iOS 完全対応 あり | Samsung Internet Android 完全対応 あり |
disabled | Chrome 完全対応 あり | Edge 完全対応 12 | Firefox 完全対応 1 | IE 完全対応 あり | Opera 完全対応 あり | Safari 完全対応 あり | WebView Android 完全対応 あり | Chrome Android 完全対応 あり | Firefox Android 完全対応 4 | Opera Android 完全対応 あり | Safari iOS 完全対応 あり | Samsung Internet Android 完全対応 あり |
form | Chrome 完全対応 あり | Edge 完全対応 16 | Firefox 完全対応 4 | IE 未対応 なし | Opera 完全対応 あり | Safari 完全対応 あり | WebView Android 完全対応 あり | Chrome Android 完全対応 あり | Firefox Android 完全対応 4 | Opera Android 完全対応 あり | Safari iOS 完全対応 あり | Samsung Internet Android 完全対応 あり |
formAction | Chrome 完全対応 あり | Edge 完全対応 12 | Firefox
完全対応
4
| IE 完全対応 あり | Opera 完全対応 あり | Safari 完全対応 あり | WebView Android 完全対応 あり | Chrome Android 完全対応 あり | Firefox Android
完全対応
4
| Opera Android 完全対応 あり | Safari iOS 完全対応 あり | Samsung Internet Android 完全対応 あり |
formEnctype | Chrome 完全対応 あり | Edge 完全対応 12 | Firefox 完全対応 4 | IE 完全対応 あり | Opera 完全対応 あり | Safari 完全対応 あり | WebView Android 完全対応 あり | Chrome Android 完全対応 あり | Firefox Android 完全対応 4 | Opera Android 完全対応 あり | Safari iOS 完全対応 あり | Samsung Internet Android 完全対応 あり |
formMethod | Chrome 完全対応 あり | Edge 完全対応 12 | Firefox 完全対応 4 | IE 完全対応 あり | Opera 完全対応 あり | Safari 完全対応 あり | WebView Android 完全対応 あり | Chrome Android 完全対応 あり | Firefox Android 完全対応 4 | Opera Android 完全対応 あり | Safari iOS 完全対応 あり | Samsung Internet Android 完全対応 あり |
formNoValidate | Chrome 完全対応 あり | Edge 完全対応 12 | Firefox 完全対応 4 | IE 完全対応 あり | Opera 完全対応 あり | Safari 完全対応 あり | WebView Android 完全対応 あり | Chrome Android 完全対応 あり | Firefox Android 完全対応 4 | Opera Android 完全対応 あり | Safari iOS 完全対応 あり | Samsung Internet Android 完全対応 あり |
formTarget | Chrome 完全対応 あり | Edge 完全対応 12 | Firefox 完全対応 4 | IE 完全対応 あり | Opera 完全対応 あり | Safari 完全対応 あり | WebView Android 完全対応 あり | Chrome Android 完全対応 あり | Firefox Android 完全対応 4 | Opera Android 完全対応 あり | Safari iOS 完全対応 あり | Samsung Internet Android 完全対応 あり |
labels | Chrome 完全対応 あり | Edge 完全対応 18 | Firefox 完全対応 56 | IE ? | Opera 完全対応 あり | Safari 完全対応 あり | WebView Android 完全対応 あり | Chrome Android 完全対応 あり | Firefox Android 完全対応 56 | Opera 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 未対応 なし |
name | Chrome 完全対応 あり | Edge 完全対応 12 | Firefox 完全対応 1 | IE 完全対応 あり | Opera 完全対応 あり | Safari 完全対応 あり | WebView Android 完全対応 あり | Chrome Android 完全対応 あり | Firefox Android 完全対応 4 | Opera Android 完全対応 あり | Safari iOS 完全対応 あり | Samsung Internet Android 完全対応 あり |
reportValidity | Chrome 完全対応 40 | Edge 完全対応 17 | Firefox 完全対応 49 | IE 未対応 なし | Opera 完全対応 27 | Safari 完全対応 10 | WebView Android 完全対応 40 | Chrome Android 完全対応 40 | Firefox Android 完全対応 64 | Opera Android 完全対応 27 | Safari iOS 完全対応 10 | Samsung Internet Android 完全対応 4.0 |
tabIndex | Chrome 完全対応 あり | Edge 完全対応 12 | Firefox 完全対応 1 | IE 完全対応 あり | Opera 完全対応 あり | Safari 完全対応 あり | WebView Android 完全対応 あり | Chrome Android 完全対応 あり | Firefox Android 完全対応 4 | Opera Android 完全対応 あり | Safari iOS 完全対応 あり | Samsung Internet Android 完全対応 あり |
type | Chrome 完全対応 あり | Edge 完全対応 12 | Firefox 完全対応 1 | IE 完全対応 あり | Opera 完全対応 あり | Safari 完全対応 あり | WebView Android 完全対応 あり | Chrome Android 完全対応 あり | Firefox Android 完全対応 4 | Opera Android 完全対応 あり | Safari iOS 完全対応 あり | Samsung Internet Android 完全対応 あり |
validationMessage | Chrome 完全対応 あり | Edge 完全対応 12 | Firefox 完全対応 1 | IE 完全対応 あり | Opera 完全対応 あり | Safari 完全対応 あり | WebView Android 完全対応 あり | Chrome Android 完全対応 あり | Firefox Android 完全対応 4 | Opera Android 完全対応 あり | Safari iOS 完全対応 あり | Samsung Internet Android 完全対応 あり |
validity | Chrome 完全対応 あり | Edge 完全対応 12 | Firefox 完全対応 1 | IE 完全対応 あり | Opera 完全対応 あり | Safari 完全対応 あり | WebView Android 完全対応 あり | Chrome Android 完全対応 あり | Firefox Android 完全対応 4 | Opera Android 完全対応 あり | Safari iOS 完全対応 あり | Samsung Internet Android 完全対応 あり |
value | Chrome 完全対応 あり | Edge 完全対応 12 | Firefox 完全対応 1 | IE 完全対応 あり | Opera 完全対応 あり | Safari 完全対応 あり | WebView Android 完全対応 あり | Chrome Android 完全対応 あり | Firefox Android 完全対応 4 | Opera Android 完全対応 あり | Safari iOS 完全対応 あり | Samsung Internet Android 完全対応 あり |
willValidate | Chrome 完全対応 あり | Edge 完全対応 12 | Firefox 完全対応 1 | IE 完全対応 あり | Opera 完全対応 あり | Safari 完全対応 あり | WebView Android 完全対応 あり | Chrome Android 完全対応 あり | Firefox Android 完全対応 4 | Opera Android 完全対応 あり | Safari iOS 完全対応 あり | Samsung Internet Android 完全対応 あり |
凡例
- 完全対応
- 完全対応
- 未対応
- 未対応
- 実装状況不明
- 実装状況不明
- 実験的。動作が変更される可能性があります。
- 実験的。動作が変更される可能性があります。
- 実装ノートを参照してください。
- 実装ノートを参照してください。
関連情報
- このインターフェイスを実装している HTML 要素:
<button>