HTMLButtonElement
=================

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

EventTarget

Node

Element

HTMLElement

HTMLButtonElementインスタンスプロパティ
-----------

*親である `HTMLElement` から継承したプロパティもあります。*

`HTMLButtonElement.accessKey`

文字列で、ボタンにアクセスするためのキーボードの 1 文字のキーを示します。

`HTMLButtonElement.autofocus`

論理値で、ページが読み込みの際、ユーザーが異なるコントロールに入力するなどで上書きをしない限り、コントロールが入力フォーカスを持つべきかどうかを示します。文書中のフォーム関連要素の中で、この属性を指定できるのは 1 つだけです。

`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.menu` 
Experimental

`HTMLMenuElement` で、ボタンが `type="menu"` である場合にクリックした場合に表示されるメニュー要素を表します。

`HTMLButtonElement.name`

文字列で、フォームを送信したときのオブジェクトの名前を表します。指定された場合は、空文字列にすることはできません。

`HTMLButtonElement.popoverTargetAction` 
Experimental

制御ボタンで制御されるポップオーバー要素で実行されるアクション（`"hide"`、`"show"`、`"toggle"` の何れか）を取得および設定します。これは HTML の `popovertargetaction` 属性の値を反映します。

`HTMLButtonElement.popoverTargetElement` 
Experimental

ボタンで制御するポップオーバー要素を取得および設定します。JavaScript において HTML の `popovertarget` 属性と同等のものです。

`HTMLButtonElement.tabIndex`

`long` で、タブ順でのこの要素の位置を表します。

`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` から継承したメソッドもあります*。

仕様書
---

| Specification |
| --- |
| HTML Standard # htmlbuttonelement |

ブラウザーの互換性
---------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

関連情報
----

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