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 で、 (もしあれば) 制約検証でコントロールが合格しなかった場合のローカライズされたメッセージを表現します。この属性はコントロールが制約検証の候補にならない場合 (willValidate が false の場合) や、制約を満たしている場合は空文字列になります。
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>
関連トピック
  1. HTMLButtonElement
  2. プロパティ
    1. labels [翻訳する]
  3. 継承
    1. HTMLElement
    2. Element
    3. Node
    4. EventTarget
  4. HTML DOM に関連するページ
    1. BeforeUnloadEvent
    2. DOMStringMap
    3. ErrorEvent
    4. GlobalEventHandlers
    5. HTMLAnchorElement
    6. HTMLAreaElement
    7. HTMLAudioElement
    8. HTMLBRElement
    9. HTMLBaseElement
    10. HTMLBaseFontElement
    11. HTMLBodyElement
    12. HTMLCanvasElement
    13. HTMLContentElement
    14. HTMLDListElement
    15. HTMLDataElement
    16. HTMLDataListElement
    17. HTMLDialogElement
    18. HTMLDivElement
    19. HTMLDocument
    20. HTMLElement
    21. HTMLEmbedElement
    22. HTMLFieldSetElement
    23. HTMLFormControlsCollection
    24. HTMLFormElement
    25. HTMLFrameSetElement
    26. HTMLHRElement
    27. HTMLHeadElement
    28. HTMLHeadingElement
    29. HTMLHtmlElement
    30. HTMLIFrameElement
    31. HTMLImageElement
    32. HTMLInputElement
    33. HTMLIsIndexElement
    34. HTMLKeygenElement
    35. HTMLLIElement
    36. HTMLLabelElement
    37. HTMLLegendElement
    38. HTMLLinkElement
    39. HTMLMapElement
    40. HTMLMediaElement
    41. HTMLMetaElement
    42. HTMLMeterElement
    43. HTMLModElement
    44. HTMLOListElement
    45. HTMLObjectElement
    46. HTMLOptGroupElement
    47. HTMLOptionElement
    48. HTMLOptionsCollection
    49. HTMLOutputElement
    50. HTMLParagraphElement
    51. HTMLParamElement
    52. HTMLPictureElement
    53. HTMLPreElement
    54. HTMLProgressElement
    55. HTMLQuoteElement
    56. HTMLScriptElement
    57. HTMLSelectElement
    58. HTMLShadowElement
    59. HTMLSourceElement
    60. HTMLSpanElement
    61. HTMLStyleElement
    62. HTMLTableCaptionElement
    63. HTMLTableCellElement
    64. HTMLTableColElement
    65. HTMLTableDataCellElement
    66. HTMLTableElement
    67. HTMLTableHeaderCellElement
    68. HTMLTableRowElement
    69. HTMLTableSectionElement
    70. HTMLTemplateElement
    71. HTMLTextAreaElement
    72. HTMLTimeElement
    73. HTMLTitleElement
    74. HTMLTrackElement
    75. HTMLUListElement
    76. HTMLUnknownElement
    77. HTMLVideoElement
    78. HashChangeEvent
    79. History
    80. ImageData
    81. Location
    82. MessageChannel
    83. MessageEvent
    84. MessagePort
    85. Navigator
    86. NavigatorGeolocation
    87. NavigatorID
    88. NavigatorLanguage
    89. NavigatorOnLine
    90. NavigatorPlugins
    91. PageTransitionEvent
    92. Plugin
    93. PluginArray
    94. PopStateEvent
    95. PortCollection
    96. PromiseRejectionEvent
    97. RadioNodeList
    98. Transferable
    99. ValidityState
    100. Window
    101. WindowBase64
    102. WindowEventHandlers
    103. WindowTimers