diff options
author | Masahiro FUJIMOTO <mfujimot@gmail.com> | 2022-02-06 17:56:17 +0900 |
---|---|---|
committer | Masahiro FUJIMOTO <mfujimot@gmail.com> | 2022-02-12 10:43:21 +0900 |
commit | 71d5a3a7239c4861b9e27c500bb8552d1847188c (patch) | |
tree | 12a0e55f493e3e42c676299b4c72004e082c15ac /files/ja/web/api | |
parent | 1ce643f3b600d5e9227cd64b0f79fa1e5d10b2af (diff) | |
download | translated-content-71d5a3a7239c4861b9e27c500bb8552d1847188c.tar.gz translated-content-71d5a3a7239c4861b9e27c500bb8552d1847188c.tar.bz2 translated-content-71d5a3a7239c4861b9e27c500bb8552d1847188c.zip |
2022/01/22 時点の英語版に同期
Diffstat (limited to 'files/ja/web/api')
-rw-r--r-- | files/ja/web/api/htmlinputelement/index.md | 842 |
1 files changed, 466 insertions, 376 deletions
diff --git a/files/ja/web/api/htmlinputelement/index.md b/files/ja/web/api/htmlinputelement/index.md index 9e01347320..2f6d58cc6f 100644 --- a/files/ja/web/api/htmlinputelement/index.md +++ b/files/ja/web/api/htmlinputelement/index.md @@ -7,420 +7,510 @@ tags: - HTML DOM - HTMLInputElement - Input - - Interface + - インターフェイス - NeedsContent - NeedsMarkupWork - - Reference + - リファレンス +browser-compat: api.HTMLInputElement translation_of: Web/API/HTMLInputElement --- -<div>{{ APIRef("HTML DOM") }}</div> +{{ APIRef("HTML DOM") }} -<p><strong><code>HTMLInputElement</code></strong> インターフェイスは {{HtmlElement("input")}} 要素のオプション、レイアウト、表示を操作するための特別なプロパティやメソッドを提供します。</p> +**`HTMLInputElement`** インターフェイスは {{HtmlElement("input")}} 要素のオプション、レイアウト、表示方法を操作するための特別なプロパティやメソッドを提供します。 -<p>{{InheritanceDiagram(600, 120)}}</p> +{{InheritanceDiagram}} -<h2 id="Properties">プロパティ</h2> +## プロパティ <table class="standard-table"> - <caption>親フォームに関連するプロパティ</caption> - <thead> - </thead> - <tbody> - <tr> - <td><code>form </code>{{readonlyInline}}</td> - <td><em>{{domxref("HTMLFormElement")}} オブジェクト:</em> 親の {{HtmlElement("form")}} 要素の参照を<strong>返します</strong>。</td> - </tr> - <tr> - <td><code>formAction</code></td> - <td><em><code>string</code>:</em> その要素の {{ htmlattrxref("formaction", "input") }} 属性を<strong>返却または設定</strong>します。ここには要素によって送信された情報を処理するプログラムの URI が入ります。これは親フォームの {{ htmlattrxref("action", "form") }} 属性を上書きします。</td> - </tr> - <tr> - <td><code>formEnctype</code></td> - <td><em><code>string</code>:</em> その要素の {{ htmlattrxref("formenctype", "input") }} 属性を<strong>返却または設定</strong>します。ここにはフォームをサーバーに送信する際のコンテンツの型が入ります。これは親フォームの {{ htmlattrxref("enctype", "form") }} 属性を上書きします。</td> - </tr> - <tr> - <td><code>formMethod</code></td> - <td><em><code>string</code>:</em> その要素の {{ htmlattrxref("formmethod", "input") }} 属性を<strong>返却または設定</strong>します。ここにはブラウザーがフォームを送信する際に用いる HTTP メソッドが入ります。これは親フォームの {{ htmlattrxref("method", "form") }} 属性を上書きします。</td> - </tr> - <tr> - <td><code>formNoValidate</code></td> - <td><em><code>boolean</code>:</em> その要素の {{ htmlattrxref("formnovalidate", "input") }} 属性を<strong>返却または設定</strong>します。これは送信時にそのフォームが検証されないかどうかを示します。これは親フォームの {{ htmlattrxref("novalidate", "form") }} 属性を上書きします。</td> - </tr> - <tr> - <td><code>formTarget</code></td> - <td><em><code>string</code>:</em> その要素の {{ htmlattrxref("formtarget", "input") }} 属性を<strong>返却または設定</strong>します。ここにはフォームを送信した後で受け取ったレスポンスを表示する場所を示す名前またはキーワードが入ります。これは親フォームの {{ htmlattrxref("target", "form") }} 属性を上書きします。</td> - </tr> - </tbody> + <caption> + 親フォームに関連するプロパティ + </caption> + <tbody> + <tr> + <td>{{domxref("HTMLInputElement.form", "form")}} {{readonlyInline}}</td> + <td> + <em>{{domxref("HTMLFormElement")}} オブジェクト:</em> 親の {{HtmlElement("form")}} 要素の参照を<strong>返します</strong>。 + </td> + </tr> + <tr> + <td>{{domxref("HTMLInputElement.formAction", "formAction")}}</td> + <td> + <em>文字列:</em> その要素の {{ htmlattrxref("formaction", "input") }} 属性を<strong>返却または設定</strong>します。ここには要素によって送信された情報を処理するプログラムの URI が入ります。これは親フォームの {{ htmlattrxref("action", "form") }} 属性を上書きします。 + </td> + </tr> + <tr> + <td>{{domxref("HTMLInputElement.formEnctype", "formEnctype")}}</td> + <td> + <em>文字列:</em> その要素の {{ htmlattrxref("formenctype", "input") }} 属性を<strong>返却または設定</strong>します。ここにはフォームをサーバーに送信する際のコンテンツの型が入ります。これは親フォームの {{ htmlattrxref("enctype", "form") }} 属性を上書きします。 + </td> + </tr> + <tr> + <td>{{domxref("HTMLInputElement.formMethod", "formMethod")}}</td> + <td> + <em>文字列:</em> その要素の {{ htmlattrxref("formmethod", "input") }} 属性を<strong>返却または設定</strong>します。ここにはブラウザーがフォームを送信する際に用いる HTTP メソッドが入ります。これは親フォームの {{ htmlattrxref("method", "form") }} 属性を上書きします。 + </td> + </tr> + <tr> + <td>{{domxref("HTMLInputElement.formNoValidate", "formNoValidate")}}</td> + <td><em>論理値:</em> その要素の {{ htmlattrxref("formnovalidate", "input") }} 属性を<strong>返却または設定</strong>します。これは送信時にそのフォームが検証されないかどうかを示します。これは親フォームの {{ htmlattrxref("novalidate", "form") }} 属性を上書きします。</td> + </tr> + <tr> + <td>{{domxref("HTMLInputElement.formTarget", "formTarget")}}</td> + <td> + <em>文字列:</em> その要素の {{ htmlattrxref("formtarget", "input") }} 属性を<strong>返却または設定</strong>します。ここにはフォームを送信した後で受け取ったレスポンスを表示する場所を示す名前またはキーワードが入ります。これは親フォームの {{ htmlattrxref("target", "form") }} 属性を上書きします。 + </td> + </tr> + </tbody> </table> <table class="standard-table"> - <caption>hidden 以外のあらゆる型の input 要素に適用されるプロパティ</caption> - <tbody> - <tr> - <td><code>name</code></td> - <td><em><code>string</code>:</em> その要素の {{ htmlattrxref("name", "input") }} 属性を<strong>返却または設定</strong>します。ここにはフォーム送信時にその要素を識別する名前が入ります。</td> - </tr> - <tr> - <td><code>type</code></td> - <td><em><code>string</code>:</em> その要素の {{ htmlattrxref("type", "input") }} 属性を<strong>返却または設定</strong>します。これは表示するコントロールの型を示します。利用可能な値については {{ HTMLElement("input") }} の {{ htmlattrxref("type", "input") }} 属性を参照してください。</td> - </tr> - <tr> - <td><code>disabled</code></td> - <td><em><code>boolean</code>:</em> その要素の {{ htmlattrxref("disabled", "input") }} 属性を<strong>返却または設定</strong>します。これはそのコントロールが対話を受け付けないかどうかを示します。その入力値はフォームとともに送信されません。 {{ htmlattrxref("readOnly", "input") }} もご覧ください。</td> - </tr> - <tr> - <td><code>autofocus</code></td> - <td><em><code>boolean</code>:</em> その要素の {{ htmlattrxref("autofocus", "input") }} 属性を<strong>返却または設定</strong>します。ページが読み込まれたときに、ユーザーが別のコントロールに入力するなどしてそれを上書きしない限り、そのフォームコントロールが入力フォーカスを持つべきであることを指定します。文書内の一つの form 要素だけが {{htmlattrxref("autofocus","input")}} 属性を持つことができます。 {{htmlattrxref("type","input")}} 属性が <code>hidden</code> に設定されている場合には適用できません (つまり、非表示のコントロールにフォーカスを自動的に設定することはできません)。</td> - </tr> - <tr> - <td><code>required</code></td> - <td><em><code>boolean</code>:</em> その要素の {{ htmlattrxref("required", "input") }} 属性を<strong>返却または設定</strong>します。これは、フォームを送信する前にユーザーが値を入力しなければならないかどうかを示します。</td> - </tr> - <tr> - <td><code>value</code></td> - <td><em><code>string</code>:</em> そのコントロールの現在の値を<strong>返却または設定</strong>します。 - <p class="note"><strong>注:</strong> ユーザーが予期しない値を入力した場合、これは空文字列を返すことがあります。</p> - </td> - </tr> - <tr> - <td><code>validity</code> {{readonlyInline}}</td> - <td><em>{{domxref("ValidityState")}}<code> オブジェクト</code>:</em> その要素の現在の検証状態を<strong>返します</strong>。</td> - </tr> - <tr> - <td><code>validationMessage</code> {{readonlyInline}}</td> - <td><em><code>string</code>:</em> 制約検証をそのコントロールが満たさなかった場合、それを記述したローカライズされたメッセージを<strong>返します</strong> (もしあれば)。これは、コントロールが制約検証の候補ではない場合 ({{htmlattrxref("willValidate","input")}} が <code>false</code> の場合)、または制約を満たしている場合は空の文字列です。この値は、 <code>setCustomValidity</code> メソッドで設定できます。</td> - </tr> - <tr> - <td><code>willValidate</code> {{readonlyInline}}</td> - <td><em><code>boolean</code>:</em> その要素が制約検証の候補であるかどうかを<strong>返します</strong>。これは何か制約検証を阻む条件がある場合、例えば、 <code>type</code> が <code>hidden</code>、<code>reset</code>、<code>button</code> のいずれかである、祖先に {{HTMLElement("datalist")}} がある、 <code>disabled</code> プロパティが <code>true</code> である、などです。</td> - </tr> - </tbody> + <caption> + hidden 以外のあらゆる型の input 要素に適用されるプロパティ + </caption> + <tbody> + <tr> + <td>{{domxref("HTMLInputElement.name", "name")}}</td> + <td> + <em>文字列:</em> その要素の {{ htmlattrxref("name", "input") }} 属性を<strong>返却または設定</strong>します。ここにはフォーム送信時にその要素を識別する名前が入ります。 + </td> + </tr> + <tr> + <td>{{domxref("HTMLInputElement.type", "type")}}</td> + <td> + <em>文字列:</em> その要素の {{ htmlattrxref("type", "input") }} 属性を<strong>返却または設定</strong>します。これは表示するコントロールの型を示します。利用可能な値については {{ HTMLElement("input") }} の {{ htmlattrxref("type", "input") }} 属性を参照してください。 + </td> + </tr> + <tr> + <td>{{domxref("HTMLInputElement.disabled", "disabled")}}</td> + <td> + <em>論理値:</em> その要素の {{ htmlattrxref("disabled", "input") }} 属性を<strong>返却または設定</strong>します。これはそのコントロールが対話を受け付けないかどうかを示します。その入力値はフォームとともに送信されません。 {{ htmlattrxref("readOnly", "input") }} もご覧ください。 + </td> + </tr> + <tr> + <td>{{domxref("HTMLInputElement.autofocus", "autofocus")}}</td> + <td> + <em>論理値:</em> その要素の {{ htmlattrxref("autofocus", "input") }} 属性を<strong>返却または設定</strong>します。ページが読み込まれたときに、ユーザーが別のコントロールに入力するなどしてそれを上書きしない限り、そのフォームコントロールが入力フォーカスを持つべきであることを指定します。文書内の一つの form 要素だけが {{htmlattrxref("autofocus","input")}} 属性を持つことができます。 {{htmlattrxref("type","input")}} 属性が <code>hidden</code> に設定されている場合には適用できません (つまり、非表示のコントロールにフォーカスを自動的に設定することはできません)。 + </td> + </tr> + <tr> + <td>{{domxref("HTMLInputElement.required", "required")}}</td> + <td> + <em>論理値:</em> その要素の {{ htmlattrxref("required", "input") }} 属性を<strong>返却または設定</strong>します。これは、フォームを送信する前にユーザーが値を入力しなければならないかどうかを示します。 + </td> + </tr> + <tr> + <td>{{domxref("HTMLInputElement.value", "value")}}</td> + <td> + <em>文字列:</em> そのコントロールの現在の値を<strong>返却または設定</strong>します。 + <p class="note"><strong>注:</strong> ユーザーが予期しない値を入力した場合、これは空文字列を返すことがあります。</p> + </td> + </tr> + <tr> + <td>{{domxref("HTMLInputElement.validity", "validity")}} {{readonlyInline}}</td> + <td><em>{{domxref("ValidityState")}} オブジェクト:</em> その要素の現在の検証状態を<strong>返します</strong>。 + </td> + </tr> + <tr> + <td>{{domxref("HTMLInputElement.validationMessage", "validationMessage")}} {{readonlyInline}}</td> + <td><em>文字列:</em> 制約検証をそのコントロールが満たさなかった場合、それを記述したローカライズされたメッセージを<strong>返します</strong> (もしあれば)。これは、コントロールが制約検証の候補ではない場合 ({{htmlattrxref("willValidate","input")}} が <code>false</code> の場合)、または制約を満たしている場合は空の文字列です。この値は、 <code>setCustomValidity</code> メソッドで設定できます。 + </td> + </tr> + <tr> + <td>{{domxref("HTMLInputElement.willValidate", "willValidate")}} {{readonlyInline}}</td> + <td><em>論理値:</em> その要素が制約検証の候補であるかどうかを<strong>返します</strong>。これは何か制約検証を阻む条件がある場合、例えば、 `type` が <code>hidden</code>、<code>reset</code>、`button` のいずれかである、祖先に {{HTMLElement("datalist")}} がある、 `disabled` プロパティが `true` である、などです。 + </td> + </tr> + </tbody> </table> -<table class="standard-table" id="Properties_checkbox_radio"> - <caption><code>checkbox</code> または <code>radio</code> 型の要素にのみに適用できるプロパティ</caption> - <tbody> - <tr> - <td><code>checked</code></td> - <td><em><code>boolean</code>:</em> {{htmlattrxref("type","input")}} が <code>checkbox</code> または <code>radio</code> の場合、要素の現在の状態を<strong>返却または設定</strong>します。</td> - </tr> - <tr> - <td><code>defaultChecked</code></td> - <td><em><code>boolean</code>:</em> このオブジェクトを生成した HTML でもともと指定されていたラジオボタンまたはチェックボックスの既定の状態を<strong>返却または設定</strong>します。</td> - </tr> - <tr> - <td><code id="indeterminate">indeterminate</code></td> - <td><em><code>boolean</code>:</em> チェックボックスやラジオボタンの状態が不確定であるかどうかを<strong>返します</strong>。チェックボックスの場合は、その状態が不確定 (チェックでも未チェックでもない状態) であることを示すために、チェックボックスの外観が何らかの方法で不明瞭になったり、灰色になったりする効果があります。 <code>checked</code> 属性の値には影響を与えず、チェックボックスをクリックするとその値は false になります。</td> - </tr> - </tbody> +<table class="standard-table"> + <caption> + <code>checkbox</code> または <code>radio</code> 型の要素にのみに適用できるプロパティ + </caption> + <tbody> + <tr> + <td>{{domxref("HTMLInputElement.checked", "checked")}}</td> + <td> + <em>論理値:</em> {{htmlattrxref("type","input")}} が <code>checkbox</code> または <code>radio</code> の場合、要素の現在の状態を<strong>返却または設定</strong>します。 + </td> + </tr> + <tr> + <td>{{domxref("HTMLInputElement.defaultChecked", "defaultChecked")}}</td> + <td> + <em>論理値:</em> このオブジェクトを生成した HTML でもともと指定されていたラジオボタンまたはチェックボックスの既定の状態を<strong>返却または設定</strong>します。 + </td> + </tr> + <tr> + <td>{{domxref("HTMLInputElement.indeterminate", "indeterminate")}}</td> + <td> + <em>論理値:</em> チェックボックスやラジオボタンの状態が不確定であるかどうかを<strong>返します</strong>。チェックボックスの場合は、その状態が不確定 (チェックでも未チェックでもない状態) であることを示すために、チェックボックスの外観が何らかの方法で不明瞭になったり、灰色になったりする効果があります。 <code>checked</code> 属性の値には影響を与えず、チェックボックスをクリックするとその値は false になります。 + </td> + </tr> + </tbody> </table> <table class="standard-table"> - <caption><code>image</code> 型の要素のみに適用できるプロパティ</caption> - <tbody> - <tr> - <td><code>alt</code></td> - <td><em><code>string</code>: </em>{{htmlattrxref("type","input")}} が <code>image</code> である場合、その要素の代替テキストが設定された {{ htmlattrxref("alt", "input") }} 属性を<strong>返却または設定</strong>します。</td> - </tr> - <tr> - <td><code>height</code></td> - <td><em><code>string</code>: </em>{{htmlattrxref("type","input")}} の値が <code>image</code> である場合、ボタンに表示される画像の高さを定義するその要素の {{ htmlattrxref("height", "input") }} 属性を<strong>返却または設定</strong>します。</td> - </tr> - <tr> - <td><code>src</code></td> - <td><code><em>string</em></code><em>:</em> {{htmlattrxref("type","input")}} の値が <code>image</code> である場合、グラフィックの送信ボタンを表示する画像の場所を示す URI を指定する、その要素の {{ htmlattrxref("src", "input") }} 属性を<strong>返却または設定</strong>します。それ以外の場合は無視されます。</td> - </tr> - <tr> - <td><code>width</code></td> - <td><code><em>string</em></code><em>:</em> {{htmlattrxref("type","input")}} の値が <code>image</code> である場合、ボタンに表示される画像の幅を定義する、文書の {{ htmlattrxref("width", "input") }} 属性を<strong>返却または設定</strong>します。</td> - </tr> - </tbody> + <caption> + <code>image</code> 型の要素のみに適用できるプロパティ + </caption> + <tbody> + <tr> + <td>{{domxref("HTMLInputElement.alt", "alt")}}</td> + <td> + <em>文字列:</em> {{htmlattrxref("type","input")}} が <code>image</code> である場合、その要素の代替テキストが設定された {{ htmlattrxref("alt", "input") }} 属性を<strong>返却または設定</strong>します。 + </td> + </tr> + <tr> + <td>{{domxref("HTMLInputElement.height", "height")}}</td> + <td> + <em>文字列:</em> {{htmlattrxref("type","input")}} の値が <code>image</code> である場合、ボタンに表示される画像の高さを定義するその要素の {{ htmlattrxref("height", "input") }} 属性を<strong>返却または設定</strong>します。 + </td> + </tr> + <tr> + <td>{{domxref("HTMLInputElement.src", "src")}}</td> + <td> + <em>文字列:</em> {{htmlattrxref("type","input")}} の値が <code>image</code> である場合、グラフィックの送信ボタンを表示する画像の場所を示す URI を指定する、その要素の {{ htmlattrxref("src", "input") }} 属性を<strong>返却または設定</strong>します。それ以外の場合は無視されます。 + </td> + </tr> + <tr> + <td>{{domxref("HTMLInputElement.width", "width")}}</td> + <td> + <em>文字列:</em> {{htmlattrxref("type","input")}} の値が <code>image</code> である場合、ボタンに表示される画像の幅を定義する、文書の {{ htmlattrxref("width", "input") }} 属性を<strong>返却または設定</strong>します。 + </td> + </tr> + </tbody> </table> -<table class="standard-table" id="Properties_file"> - <caption><code>file</code> 型の要素のみに適用できるプロパティ</caption> - <tbody> - <tr> - <td><code>accept</code></td> - <td><em><code>string</code>: </em>{{htmlattrxref("type","input")}} が <code>file</code> である場合、サーバーが受け入れるファイル形式をカンマ区切りのリストで表すその要素の {{ htmlattrxref("accept", "input") }} 属性を<strong>返却または設定</strong>します。</td> - </tr> - <tr> - <td><code>allowdirs</code> {{non-standard_inline}}</td> - <td><em><code>boolean</code>:</em> 標準外の Directory Upload API の一部です。ファイルリストでディレクトリーとファイルの両方を選択できるようにするかどうかを<strong>示します</strong>。 Firefox でのみ実装されており、設定で隠されています。</td> - </tr> - <tr> - <td><code id="files_prop">files</code></td> - <td>{{domxref("FileList")}} オブジェクトを<strong>返却または設定</strong>し、これはアップロードするために選択されたファイルを表す {{domxref("File")}} オブジェクトのリストが入ります。</td> - </tr> - <tr> - <td>{{domxref("HTMLInputElement.webkitdirectory", "webkitdirectory")}} {{Non-standard_inline}}</td> - <td><em><code>boolean</code>:</em> {{htmlattrxref("webkitdirectory", "input")}} 属性を<strong>返します</strong>。 true の場合、ファイルシステム選択インターフェイスはファイルではなくディレクトリーのみが選択できるようになります。</td> - </tr> - <tr> - <td>{{domxref("HTMLInputElement.webkitEntries", "webkitEntries")}} {{Non-standard_inline}}</td> - <td><em>{{domxref("FileSystemEntry")}} オブジェクトの配列:</em> 現在選択されているファイルまたはディレクトリーを<strong>示します</strong>。</td> - </tr> - </tbody> +<table class="standard-table"> + <caption> + <code>file</code> 型の要素のみに適用できるプロパティ + </caption> + <tbody> + <tr> + <td>{{domxref("HTMLInputElement.accept", "accept")}}</td> + <td> + <em>文字列:</em> {{htmlattrxref("type","input")}} が <code>file</code> である場合、サーバーが受け入れるファイル形式をカンマ区切りのリストで表すその要素の {{ htmlattrxref("accept", "input") }} 属性を<strong>返却または設定</strong>します。 + </td> + </tr> + <tr> + <td>{{domxref("HTMLInputElement.allowdirs", "allowdirs")}} {{non-standard_inline}}</td> + <td> + <em>論理値:</em> 標準外の Directory Upload API の一部です。ファイルリストでディレクトリーとファイルの両方を選択できるようにするかどうかを<strong>示します</strong>。 Firefox でのみ実装されており、設定で隠されています。 + </td> + </tr> + <tr> + <td>{{domxref("HTMLInputElement.files", "files")}}</td> + <td> + {{domxref("FileList")}} オブジェクトを<strong>返却または設定</strong>し、これはアップロードするために選択されたファイルを表す {{domxref("File")}} オブジェクトのリストが入ります。 + </td> + </tr> + <tr> + <td> + {{domxref("HTMLInputElement.webkitdirectory", "webkitdirectory")}} + {{Non-standard_inline}} + </td> + <td> + <em>論理値:</em> {{htmlattrxref("webkitdirectory", "input")}} 属性を<strong>返します</strong>。 true の場合、ファイルシステム選択インターフェイスはファイルではなくディレクトリーのみが選択できるようになります。 + </td> + </tr> + <tr> + <td> + {{domxref("HTMLInputElement.webkitEntries", "webkitEntries")}} + {{Non-standard_inline}} + </td> + <td> + <em>{{domxref("FileSystemEntry")}} オブジェクトの配列:</em> 現在選択されているファイルまたはディレクトリーを<strong>示します</strong>。 + </td> + </tr> + </tbody> </table> <table class="standard-table"> - <caption><code>text/number</code> を含む型の要素のみに適用できるプロパティ</caption> - <tbody> - <tr> - <td><code>autocomplete</code></td> - <td><em><code>string</code>: </em>その要素の {{htmlattrxref("autocomplete", "input")}} 属性を<strong>返却または設定</strong>します。これはコントロールの値をブラウザーで自動的に補完できるかどうかを示します。 {{htmlattrxref("type","input")}} 属性の値が <code>hidden</code>、<code>checkbox</code>、<code>radio</code>、<code>file</code>、またはボタン型 (<code>button</code>、<code>submit</code>、<code>reset</code>、<code>image</code>) の場合は無視されます。可能な値は次の通りです。<br> - <code>on</code>: ブラウザーが以前入力された値を使用して値を自動補完することができる<br> - <code>off</code>: ユーザーは明示的に値を入力しなければならない</td> - </tr> - <tr> - <td><code>max</code></td> - <td><em><code>string</code>:</em> その要素の {{ htmlattrxref("max", "input") }} 属性を<strong>返却または設定</strong>します。この属性には、この項目の (数値または日時の) 最大値が含まれ、最小値 ({{htmlattrxref("min","input")}} 属性) より小さくすることはできません。</td> - </tr> - <tr> - <td><code>maxLength</code></td> - <td><em><code>long</code>:</em> その要素の {{ htmlattrxref("maxlength", "input") }} 属性を<strong>返却または設定</strong>します。この属性には、値が持つことのできる (Unicode コードポイントでの) <u><strong>最大文字数</strong></u>が含まれます。 (これを負の数に設定した場合、例外が発生します。)</td> - </tr> - <tr> - <td><code>min</code></td> - <td><em><code>string</code>:</em> その要素の {{ htmlattrxref("min", "input") }} 属性を<strong>返却または設定</strong>します。この属性には、この項目の (数値または日時の) 最小値が含まれ、最大値 ({{htmlattrxref("max","input")}} 属性) より大きくすることはできません。</td> - </tr> - <tr> - <td><code>minLength</code></td> - <td><em><code>long</code>:</em> その要素の {{ htmlattrxref("minlength", "input") }} 属性を<strong>返却または設定</strong>します。この属性には、値が持つことのできる (Unicode コードポイントでの) <u><strong>最小文字数</strong></u>が含まれます。 (これを負の数に設定した場合、例外が発生します。)</td> - </tr> - <tr> - <td><code>pattern</code></td> - <td><em><code>string</code>:</em> その要素の {{ htmlattrxref("pattern", "input") }} 属性を<strong>返却または設定</strong>します。ここにはコントロールの値をチェックするための<u><strong>正規表現</strong></u>を含みます。 {{htmlattrxref("title","input")}} 属性を使用してユーザーにパターンを説明してください。この属性は、 {{htmlattrxref("type","input")}} 属性の値が <code>text</code>、<code>search</code>、<code>tel</code>、<code>url</code>、<code>email</code> の場合に適用され、それ以外の場合は無視されます。</td> - </tr> - <tr> - <td><code>placeholder</code></td> - <td><em><code>string</code>: </em>その要素の {{ htmlattrxref("placeholder", "input") }} 属性を<strong>返却または設定</strong>します。ここには、ユーザーがコントロールに何を入力できるかのヒントが設定されます。プレイスホルダーのテキストには、キャリッジリターンやラインフィードを含むことはできません。この属性は、type属性の値がtext、search、tel、url、emailの場合に適用され、それ以外の場合は無視されます。この属性は、 {{htmlattrxref("type","input")}} 属性の値が <code>text</code>、<code>search</code>、<code>tel</code>、<code>url</code>、<code>email</code> の場合に適用され、それ以外の場合は無視されます。</td> - </tr> - <tr> - <td><code>readOnly</code></td> - <td><em><code>boolean</code>:</em>その要素の {{ htmlattrxref("readonly", "input") }} 属性を<strong>返却または設定</strong>します。これは、ユーザーがコントロールの値を変更できないことを示します。<br> - {{htmlattrxref("type","input")}} 属性の値が <code>hidden</code>、<code>range</code>、<code>color</code>、<code>checkbox</code>、<code>radio</code>、<code>file</code>、またはボタン型の場合は無視されます。</td> - </tr> - <tr> - <td><code>selectionStart</code></td> - <td><em><code>unsigned long</code>:</em> 選択中のテキストの先頭の位置を<strong>返却または設定</strong>します。何も選択していない場合は、その {{HTMLElement("input")}} 要素内にあるテキスト入力カーソル (キャレット) の位置を返します。</td> - </tr> - <tr> - <td><code>selectionEnd</code></td> - <td><em><code>unsigned long</code>:</em> 選択中のテキストの末尾の位置を<strong>返却または設定</strong>します。選択がない場合は、現在のテキスト入力カーソル位置の直後の文字のオフセットを返します。</td> - </tr> - <tr> - <td><code>selectionDirection</code></td> - <td><em><code>string</code>:</em> 選択が行われた方向を<strong>返却または設定</strong>します。可能な値は次のとおりです。<br> - <code>forward</code> は現在のロケールにおいての先頭から末尾の方向で選択された場合<br> - <code>backward</code> は逆方向の場合<br> - <code>none</code> は方向が不明な場合</td> - </tr> - <tr> - <td><code>size</code></td> - <td><em><code>unsigned long</code>:</em> その要素の {{ htmlattrxref("size", "input") }} 属性を<strong>返却または設定</strong>します。これは<u><strong>コントロールの外見の大きさ</strong></u>が入ります。この値は {{htmlattrxref("type","input")}} の値が <code>text</code> または <code>password</code> の場合は整数で文字数であり、それ以外の場合はピクセル単位です。 {{htmlattrxref("type","input")}} が <code>text</code>、<code>search</code>、<code>tel</code>、<code>url</code>、<code>email</code>、<code>password</code> のいずれかに設定されている場合のみ適用され、それ以外の場合は無視されます。</td> - </tr> - </tbody> + <caption> + <code>text/number</code> を含む型の要素のみに適用できるプロパティ + </caption> + <tbody> + <tr> + <td>{{domxref("HTMLInputElement.autocomplete", "autocomplete")}}</td> + <td> + <em>文字列:</em> その要素の {{htmlattrxref("autocomplete", "input")}} 属性を<strong>返却または設定</strong>します。これはコントロールの値をブラウザーで自動的に補完できるかどうかを示します。 {{htmlattrxref("type","input")}} 属性の値が <code>hidden</code>、<code>checkbox</code>、<code>radio</code>、<code>file</code>、またはボタン型 (<code>button</code>、<code>submit</code>、<code>reset</code>、<code>image</code>) の場合は無視されます。可能な値は次の通りです。<br> + <code>on</code>: ブラウザーが以前入力された値を使用して値を自動補完することができる<br> + <code>off</code>: ユーザーは明示的に値を入力しなければならない + </td> + </tr> + <tr> + <td>{{domxref("HTMLInputElement.max", "max")}}</td> + <td> + <em>文字列:</em> その要素の {{ htmlattrxref("max", "input") }} 属性を<strong>返却または設定</strong>します。この属性には、この項目の (数値または日時の) 最大値が含まれ、最小値 ({{htmlattrxref("min","input")}} 属性) より小さくすることはできません。 + </td> + </tr> + <tr> + <td>{{domxref("HTMLInputElement.maxLength", "maxLength")}}</td> + <td> + <em><code>long</code>:</em> その要素の {{ htmlattrxref("maxlength", "input") }} 属性を<strong>返却または設定</strong>します。この属性には、値が持つことのできる (Unicode コードポイントでの) <u><strong>最大文字数</strong></u>が含まれます。 (これを負の数に設定した場合、例外が発生します。) + </td> + </tr> + <tr> + <td>{{domxref("HTMLInputElement.min", "min")}}</td> + <td> + <em>文字列:</em> その要素の {{ htmlattrxref("min", "input") }} 属性を<strong>返却または設定</strong>します。この属性には、この項目の (数値または日時の) 最小値が含まれ、最大値 ({{htmlattrxref("max","input")}} 属性) より大きくすることはできません。 + </td> + </tr> + <tr> + <td>{{domxref("HTMLInputElement.minLength", "minLength")}}</td> + <td> + <em><code>long</code>:</em> その要素の {{ htmlattrxref("minlength", "input") }} 属性を<strong>返却または設定</strong>します。この属性には、値が持つことのできる (Unicode コードポイントでの) <u><strong>最小文字数</strong></u>が含まれます。 (これを負の数に設定した場合、例外が発生します。) + </td> + </tr> + <tr> + <td>{{domxref("HTMLInputElement.pattern", "pattern")}}</td> + <td> + <em>文字列:</em> その要素の {{ htmlattrxref("pattern", "input") }} 属性を<strong>返却または設定</strong>します。ここにはコントロールの値をチェックするための<u><strong>正規表現</strong></u>を含みます。 {{htmlattrxref("title","input")}} 属性を使用してユーザーにパターンを説明してください。この属性は、 {{htmlattrxref("type","input")}} 属性の値が <code>text</code>、<code>search</code>、<code>tel</code>、<code>url</code>、<code>email</code> の場合に適用され、それ以外の場合は無視されます。 + </td> + </tr> + <tr> + <td>{{domxref("HTMLInputElement.placeholder", "placeholder")}}</td> + <td> + <em>文字列:</em> その要素の {{ htmlattrxref("placeholder", "input") }} 属性を<strong>返却または設定</strong>します。ここには、ユーザーがコントロールに何を入力できるかのヒントが設定されます。プレイスホルダーのテキストには、キャリッジリターンやラインフィードを含むことはできません。この属性は、 {{htmlattrxref("type","input")}} 属性の値が <code>text</code>、<code>search</code>、<code>tel</code>、<code>url</code>、<code>email</code> の場合に適用され、それ以外の場合は無視されます。 + </td> + </tr> + <tr> + <td>{{domxref("HTMLInputElement.readOnly", "readOnly")}}</td> + <td> + <em>論理値:</em> その要素の {{ htmlattrxref("readonly", "input") }} 属性を<strong>返却または設定</strong>します。これは、ユーザーがコントロールの値を変更できないことを示します。<br> + {{htmlattrxref("type","input")}} 属性の値が <code>hidden</code>、<code>range</code>、<code>color</code>、<code>checkbox</code>、<code>radio</code>、<code>file</code>、またはボタン型の場合は無視されます。 + </td> + </tr> + <tr> + <td>{{domxref("HTMLInputElement.selectionStart", "selectionStart")}}</td> + <td><em><code>unsigned long</code>:</em> 選択中のテキストの先頭の位置を<strong>返却または設定</strong>します。何も選択していない場合は、その {{HTMLElement("input")}} 要素内にあるテキスト入力カーソル (キャレット) の位置を返します。 + </td> + </tr> + <tr> + <td>{{domxref("HTMLInputElement.selectionEnd", "selectionEnd")}}</td> + <td> + <em><code>unsigned long</code>:</em> 選択中のテキストの末尾の位置を<strong>返却または設定</strong>します。選択がない場合は、現在のテキスト入力カーソル位置の直後の文字のオフセットを返します。 + </td> + </tr> + <tr> + <td>{{domxref("HTMLInputElement.selectionDirection", "selectionDirection")}}</td> + <td> + <em>文字列:</em> 選択が行われた方向を<strong>返却または設定</strong>します。可能な値は次のとおりです。<br> + <code>forward</code> は現在のロケールにおいての先頭から末尾の方向で選択された場合<br> + <code>backward</code> は逆方向の場合<br> + <code>none</code> は方向が不明な場合 + </td> + </tr> + <tr> + <td>{{domxref("HTMLInputElement.size", "size")}}</td> + <td> + <em><code>unsigned long</code>:</em> その要素の {{ htmlattrxref("size", "input") }} 属性を<strong>返却または設定</strong>します。これは<u><strong>コントロールの外見の大きさ</strong></u>が入ります。この値は {{htmlattrxref("type","input")}} の値が <code>text</code> または <code>password</code> の場合は整数で文字数であり、それ以外の場合はピクセル単位です。 {{htmlattrxref("type","input")}} が <code>text</code>、<code>search</code>、<code>tel</code>、<code>url</code>、<code>email</code>、<code>password</code> のいずれかに設定されている場合のみ適用され、それ以外の場合は無視されます。 + </td> + </tr> + </tbody> </table> <table class="standard-table"> - <caption>未分類のプロパティ</caption> - <tbody> - <tr> - <td><code>defaultValue</code></td> - <td><em><code>string</code>:</em> このオブジェクトを生成した HTML で最初に指定された既定値を<strong>返却または設定</strong>します。</td> - </tr> - <tr> - <td><code>dirName</code></td> - <td><em><code>string</code>:</em> 要素の書字方向を<strong>返却または設定</strong>します。</td> - </tr> - <tr> - <td><code>accessKey</code></td> - <td><em><code>string</code>: </em>押されるとコントロールへの入力フォーカスを切り替える単一の文字が入った文字列を<strong>返します</strong>。</td> - </tr> - <tr> - <td><code>list</code> {{readonlyInline}}</td> - <td><em>{{domxref("HTMLElement")}}<code> object</code>:</em> {{ htmlattrxref("list", "input") }} 属性が指す要素を<strong>返します</strong>。同じツリーに HTML 要素がない場合、プロパティは <code>null</code> になることがあります。</td> - </tr> - <tr> - <td><code>multiple</code></td> - <td><em><code>boolean</code>:</em> その要素の {{ htmlattrxref("multiple", "input") }} 属性を<strong>返却または設定</strong>します。これは複数の値 (例えば複数のファイル) を持つことが可能であるかどうかを示します。</td> - </tr> - <tr> - <td><code>files</code></td> - <td><em>{{domxref("FileList")}}<code> array</code>:</em> 選択されたファイルのリストを<strong>返します</strong>。</td> - </tr> - <tr> - <td>{{domxref("HTMLInputElement.labels")}} {{readonlyInline}}</td> - <td><em>{{domxref("NodeList")}}<code> array</code>:</em> この要素のラベルである {{ HTMLElement("label") }} 要素のリストを<strong>返します</strong>。</td> - </tr> - <tr> - <td><code>step</code></td> - <td><code><em>string</em></code><em>:</em> その要素の {{ htmlattrxref("step", "input") }} 属性を<strong>返却または設定</strong>します。これは、 {{htmlattrxref("min","input")}} や {{htmlattrxref("max","input")}} と共に、数値や日時の値を設定する際の増分を制限します。文字列 <code>any</code> または正の浮動小数点数を設定することができます。 <code>any</code> が設定されていない場合、コントロールは最小値よりも大きい step 値の倍数のみを受け入れます。</td> - </tr> - <tr> - <td><code>valueAsDate</code></td> - <td><em>{{jsxref("Date")}}<code> object</code>:</em> その要素の値を、日時として解釈して<strong>返却または設定</strong>します。変換が不可能であれば <code>null</code> を返します。</td> - </tr> - <tr> - <td><code>valueAsNumber</code></td> - <td><em><code>double</code>:</em> その要素の値を、次のいずれかのうち一つとして解釈して<strong>返します</strong>。解釈は以下の順で行われます。 - <ul> - <li>時刻の値</li> - <li>数値</li> - <li>変換が不可能であれば <code>NaN</code></li> - </ul> - </td> - </tr> - <tr> - <td><code>autocapitalize</code> {{experimental_inline}}</td> - <td><code><em>string</em></code><em>:</em> ユーザーの入力を大文字化する動作を<strong>定義します</strong>。有効な値は <code>none</code>、<code>off</code>、<code>characters</code>、<code>words</code>、<code>sentences</code> です。</td> - </tr> - <tr> - <td><code>inputmode</code></td> - <td>この要素またはその内容を編集する際に使用する仮想キーボード設定の種類について、ブラウザーにヒントを与えます。</td> - </tr> - </tbody> + <caption> + 未分類のプロパティ + </caption> + <tbody> + <tr> + <td>{{domxref("HTMLInputElement.defaultValue", "defaultValue")}}</td> + <td> + <em>文字列:</em> このオブジェクトを生成した HTML で最初に指定された既定値を<strong>返却または設定</strong>します。 + </td> + </tr> + <tr> + <td>{{domxref("HTMLInputElement.dirName", "dirName")}}</td> + <td> + <em>文字列:</em> 要素の書字方向を<strong>返却または設定</strong>します。 + </td> + </tr> + <tr> + <td>{{domxref("HTMLElement.accessKey", "accessKey")}}</td> + <td> + <em>文字列:</em> 押されるとコントロールへの入力フォーカスを切り替える単一の文字が入った文字列を<strong>返します</strong>。 + </td> + </tr> + <tr> + <td>{{domxref("HTMLInputElement.list", "list")}} {{readonlyInline}}</td> + <td> + <em>{{domxref("HTMLElement")}} オブジェクト:</em> {{ htmlattrxref("list", "input") }} 属性が指す要素を<strong>返します</strong>。同じツリーに HTML 要素がない場合、プロパティは <code>null</code> になることがあります。 + </td> + </tr> + <tr> + <td>{{domxref("HTMLInputElement.multiple", "multiple")}}</td> + <td> + <em>論理値:</em> その要素の {{ htmlattrxref("multiple", "input") }} 属性を<strong>返却または設定</strong>します。これは複数の値 (例えば複数のファイル) を持つことが可能であるかどうかを示します。 + </td> + </tr> + <tr> + <td>{{domxref("HTMLInputElement.files", "files")}}</td> + <td> + <em>{{domxref("FileList")}} の配列:</em> 選択されたファイルのリストを<strong>返します</strong>。 + </td> + </tr> + <tr> + <td>{{domxref("HTMLInputElement.labels", "labels")}} {{readonlyInline}}</td> + <td> + <em>{{domxref("NodeList")}} の配列:</em> この要素のラベルである {{ HTMLElement("label") }} 要素のリストを<strong>返します</strong>。 + </td> + </tr> + <tr> + <td>{{domxref("HTMLInputElement.step", "step")}}</td> + <td> + <em>文字列:</em> その要素の {{ htmlattrxref("step", "input") }} 属性を<strong>返却または設定</strong>します。これは、 {{htmlattrxref("min","input")}} や {{htmlattrxref("max","input")}} と共に、数値や日時の値を設定する際の増分を制限します。文字列 <code>any</code> または正の浮動小数点数を設定することができます。 <code>any</code> が設定されていない場合、コントロールは最小値よりも大きい step 値の倍数のみを受け入れます。 + </td> + </tr> + <tr> + <td>{{domxref("HTMLInputElement.valueAsDate", "valueAsDate")}}</td> + <td> + <em>{{jsxref("Date")}} オブジェクト:</em> その要素の値を、日時として解釈して<strong>返却または設定</strong>します。変換が不可能であれば <code>null</code> を返します。 + </td> + </tr> + <tr> + <td>{{domxref("HTMLInputElement.valueAsNumber", "valueAsNumber")}}</td> + <td> + <em><code>double</code>:</em> その要素の値を、次のいずれかのうち一つとして解釈して<strong>返します</strong>。解釈は以下の順で行われます。 + <ul> + <li>時刻の値</li> + <li>数値</li> + <li>変換が不可能であれば `NaN`</li> + </ul> + </td> + </tr> + <tr> + <td>{{domxref("HTMLInputElement.autocapitalize", "autocapitalize")}} {{experimental_inline}}</td> + <td> + <em>文字列:</em> ユーザーの入力を大文字化する動作を<strong>定義します</strong>。有効な値は <code>none</code>, <code>off</code>, <code>characters</code>, <code>words</code>, <code>sentences</code> です。 + </td> + </tr> + <tr> + <td>{{domxref("HTMLInputElement.inputmode", "inputmode")}}</td> + <td> + この要素またはその内容を編集する際に使用する仮想キーボード設定の種類について、ブラウザーにヒントを与えます。 + </td> + </tr> + </tbody> </table> -<dl> - <dt>{{domxref("HTMLInputElement.align")}} {{obsolete_inline}}</dt> - <dd><code><em>string</em></code><em>:</em> 要素の配置を<strong>表します</strong>。<em>代わりに CSS を使用してください。</em></dd> - <dt>{{domxref("HTMLInputElement.useMap")}} {{ obsolete_inline }}</dt> - <dd><code><em>string</em></code><em>:</em> クライアント側イメージマップを<strong>表します</strong>。</dd> -</dl> +- {{domxref("HTMLInputElement.align", "align")}} {{deprecated_inline}} + - : _文字列:_ 要素の配置を**表します**。_代わりに CSS を使用してください。_ +- {{domxref("HTMLInputElement.useMap", "useMap")}} {{deprecated_inline}} + - : _文字列:_ クライアント側イメージマップを**表します**。 -<h2 id="Methods">メソッド</h2> +## メソッド <table class="standard-table"> - <tbody> - <tr> - <td>{{domxref("HTMLOrForeignElement/blur", "blur()")}}</td> - <td>input 要素からフォーカスを外します。キー入力はどこにも行かなくなります。</td> - </tr> - <tr> - <td>{{domxref("HTMLElement.click()", "click()")}}</td> - <td>input 要素のクリックをシミュレートします。</td> - </tr> - <tr> - <td>{{domxref("HTMLOrForeignElement/focus", "focus()")}}</td> - <td>input 要素にフォーカスを与えます。キー入力がこの要素に行くようになります。</td> - </tr> - <tr> - <td>{{domxref("HTMLInputElement.select()", "select()")}}</td> - <td>input 要素のすべてのテキストを選択し、ユーザーがその内容をすべて置き換えることができるように、テキストにフォーカスを与えます。</td> - </tr> - <tr> - <td>{{domxref("HTMLInputElement.setSelectionRange()", "setSelectionRange()")}}</td> - <td>input 要素のテキストの範囲を選択します (ただし、フォーカスは与えません)。</td> - </tr> - <tr> - <td>{{domxref("HTMLInputElement.setRangeText()", "setRangeText()")}}</td> - <td>input 要素のテキストの範囲を新しいテキストで置き換えます。</td> - </tr> - <tr> - <td><code>setCustomValidity()</code></td> - <td>要素に独自の検証メッセージ設定します。このメッセージが空の文字列ではない場合、その要素は独自の検証のエラーに見舞われており、検証に不合格になります。</td> - </tr> - <tr> - <td><code>checkValidity()</code></td> - <td><code>boolean</code> を返します。 <code>false</code> の場合はその要素が制約検証の候補であり、制約を満たしていないことを表します。この場合、その要素で {{event("invalid")}} イベントも発生します。 <code>true</code> の場合はその要素が制約検証の候補でないか、制約を満たしていることを表します。</td> - </tr> - <tr> - <td><code>reportValidity()</code></td> - <td><code>checkValidity()</code> メソッドを実行し、 false が返された場合 (無効な入力や pattern 属性が提供されていない場合) には、フォームを送信した場合と同様に、入力が無効であることをユーザーに報告します。</td> - </tr> - </tbody> + <tbody> + <tr> + <td>{{domxref("HTMLElement/blur", "blur()")}}</td> + <td> + input 要素からフォーカスを外します。キー入力はどこにも行かなくなります。 + </td> + </tr> + <tr> + <td>{{domxref("HTMLElement.click()", "click()")}}</td> + <td> + input 要素のクリックをシミュレートします。 + </td> + </tr> + <tr> + <td>{{domxref("HTMLElement/focus", "focus()")}}</td> + <td> + input 要素にフォーカスを与えます。キー入力がこの要素に行くようになります。 + </td> + </tr> + <tr> + <td>{{domxref("HTMLInputElement.select()", "select()")}}</td> + <td> + input 要素のすべてのテキストを選択し、ユーザーがその内容をすべて置き換えることができるように、テキストにフォーカスを与えます。 + </td> + </tr> + <tr> + <td>{{domxref("HTMLInputElement.setSelectionRange()", "setSelectionRange()")}}</td> + <td> + input 要素のテキストの範囲を選択します (ただし、フォーカスは与えません)。 + </td> + </tr> + <tr> + <td>{{domxref("HTMLInputElement.setRangeText()", "setRangeText()")}}</td> + <td>input 要素のテキストの範囲を新しいテキストで置き換えます。</td> + </tr> + <tr> + <td>{{domxref("HTMLInputElement.setCustomValidity()", "setCustomValidity()")}}</td> + <td> + 要素に独自の検証メッセージ設定します。このメッセージが空の文字列ではない場合、その要素は独自の検証のエラーに見舞われており、検証に不合格になります。 + </td> + </tr> + <tr> + <td>{{domxref("HTMLInputElement.showPicker()", "showPicker()")}}</td> + <td> + 日付、時刻、色、ファイルのブラウザーのピッカーを表示します。 + </td> + </tr> + <tr> + <td>{{domxref("HTMLInputElement.checkValidity()", "checkValidity()")}}</td> + <td> + 論理値を返します。 <code>false</code> の場合はその要素が制約検証の候補であり、制約を満たしていないことを表します。この場合、その要素で {{domxref("HTMLInputElement/invalid_event", "invalid")}} イベントも発生します。 <code>true</code> の場合はその要素が制約検証の候補でないか、制約を満たしていることを表します。 + </td> + </tr> + <tr> + <td>{{domxref("HTMLInputElement.reportValidity()", "reportValidity()")}}</td> + <td> + <code>checkValidity()</code> メソッドを実行し、 false が返された場合 (無効な入力や pattern 属性が提供されていない場合) には、フォームを送信した場合と同様に、入力が無効であることをユーザーに報告します。 + </td> + </tr> + </tbody> </table> -<dl> - <dt>{{domxref("HTMLInputElement.stepDown()")}}</dt> - <dd>{{htmlattrxref("value","input")}} を ({{htmlattrxref("step","input")}} * n) だけ減少させます。 n が指定されなかった場合の既定値は 1 です。次の場合は INVALID_STATE_ERR 例外が発生します。 - <ul> - <li>現在の {{htmlattrxref("type","input")}} の値にこのメソッドが適用できない場合</li> - <li>要素に {{htmlattrxref("step","input")}} 値が設定されていない場合</li> - <li>{{htmlattrxref("value","input")}} が数値に変換できない場合</li> - <li>結果の値が {{htmlattrxref("max","input")}} を超えたり、 {{htmlattrxref("min","input")}} を下回ったりする場合</li> - </ul> - </dd> - <dt>{{domxref("HTMLInputElement.stepUp()")}}</dt> - <dd>{{htmlattrxref("value","input")}} を ({{htmlattrxref("step","input")}} * n) だけ増加させます。 n が指定されなかった場合の既定値は 1 です。次の場合は INVALID_STATE_ERR 例外が発生します。 - <ul> - <li>現在の {{htmlattrxref("type","input")}} の値にこのメソッドが適用できない場合</li> - <li>要素に {{htmlattrxref("step","input")}} 値が設定されていない場合</li> - <li>{{htmlattrxref("value","input")}} が数値に変換できない場合</li> - <li>結果の値が {{htmlattrxref("max","input")}} を超えたり、 {{htmlattrxref("min","input")}} を下回ったりする場合</li> - </ul> - </dd> - <dt>{{domxref("HTMLInputElement.mozSetFileArray()")}} {{non-standard_inline}}</dt> - <dd>入力欄で選択されたファイルを、与えられた {{domxref("File")}} オブジェクトの配列に設定します。これは、フレームスクリプトで使用可能な <code>mozSetFileNameArray()</code> の代替となるものです。クロームスクリプトは<a href="/ja/docs/Extensions/Using_the_DOM_File_API_in_chrome_code">ファイルを File オブジェクトとして開き</a>、<a href="/ja/docs/Mozilla/Firefox/Multiprocess_Firefox/The_message_manager">メッセージマネージャー</a>を介してそれらを送信することができます。</dd> - <dt>{{domxref("HTMLInputElement.mozGetFileNameArray()")}} {{non-standard_inline}}</dt> - <dd>その入力欄からすべてのファイル名の配列を返します。</dd> - <dt>{{domxref("HTMLInputElement.mozSetFileNameArray()")}} {{non-standard_inline}}</dt> - <dd>入力で選択されたファイルのファイル名を設定します。ファイルシステムにアクセスするので、<a href="/ja/docs/Mozilla/Firefox/Multiprocess_Firefox/Limitations_of_frame_scripts">フレームスクリプト</a>では使用できません。</dd> -</dl> +- {{domxref("HTMLInputElement.stepDown()", "stepDown()")}} -<h2 id="Events">イベント</h2> + - : {{htmlattrxref("value","input")}} を ({{htmlattrxref("step","input")}} * n) だけ減少させます。 n が指定されなかった場合の既定値は 1 です。次の場合は `InvalidStateError` 例外が発生します。 -<p>以下のイベントは、 <code><a href="/ja/docs/Web/API/EventTarget/addEventListener">addEventListener()</a></code> を用いるか、このインターフェイスの <code>on<em>イベント名</em></code> プロパティにイベントリスナーを割り当てるかして待ち受けしてください。</p> + - 現在の {{htmlattrxref("type","input")}} の値にこのメソッドが適用できない場合 + - 要素に {{htmlattrxref("step","input")}} 値が設定されていない場合 + - {{htmlattrxref("value","input")}} が数値に変換できない場合 + - 結果の値が {{htmlattrxref("max","input")}} を超えたり、 {{htmlattrxref("min","input")}} を下回ったりする場合 -<dl> - <dt><a href="/ja/docs/Web/API/HTMLElement/input_event"><code>input</code></a></dt> - <dd>{{HTMLElement("input")}}、{{HTMLElement("select")}}、{{HTMLElement("textarea")}} のいずれかの要素の <code>value</code> が変更されたときに発生します。なお、このイベントは実際には {{domxref("HTMLElement")}} インターフェイス上で発生し、 <code><a href="/ja/docs/Web/HTML/Global_attributes/contenteditable">contenteditable</a></code> 要素にも適用されますが、フォーム入力要素で最も一般的に使用されるため、ここに挙げています。<br> -<code><a href="/ja/docs/Web/API/GlobalEventHandlers/oninput">oninput</a></code> イベントハンドラープロパティからも利用できます。</dd> - <dt><code><a href="/ja/docs/Web/API/HTMLInputElement/invalid_event">invalid</a></code></dt> - <dd>制約検証時に、要素が制約を満たしていなかった場合に発生します。<br> - <code><a href="/ja/docs/Web/API/GlobalEventHandlers/oninvalid">oninvalid</a></code> イベントハンドラープロパティからも利用できます。</dd> - <dt><code><a href="/ja/docs/Web/API/HTMLInputElement/search_event">search</a></code></dt> - <dd>{{HTMLElement("input")}} の <code>type="search"</code> で検索が開始されたときに発生します。<br> - <code><a href="/ja/docs/Web/API/GlobalEventHandlers/onsearch">onsearch</a></code> イベントハンドラープロパティからも利用できます。</dd> -</dl> +- {{domxref("HTMLInputElement.stepUp()", "stepUp()")}} -<h2 id="Specifications">仕様書</h2> + - : {{htmlattrxref("value","input")}} を ({{htmlattrxref("step","input")}} * n) だけ増加させます。 n が指定されなかった場合の既定値は 1 です。次の場合は INVALID_STATE_ERR 例外が発生します。 -<table class="standard-table"> - <thead> - <tr> - <th scope="col">仕様書</th> - <th scope="col">状態</th> - <th scope="col">備考</th> - </tr> - </thead> - <tbody> - <tr> - <td>{{SpecName('HTML WHATWG', "#htmlinputelement", "HTMLInputElement")}}</td> - <td>{{Spec2('HTML WHATWG')}}</td> - <td></td> - </tr> - <tr> - <td>{{SpecName('HTML5 W3C', "forms.html#the-input-element", "HTMLInputElement")}}</td> - <td>{{Spec2('HTML5 W3C')}}</td> - <td>技術的に、<code>tabindex</code> と <code>accesskey</code> の各プロパティ、ならびに <code>blur()</code>、<code>click()</code>、<code>focus()</code> の各メソッドが {{domxref("HTMLElement")}} で定義されるようになりました。<br> - 次のプロパティは廃止されました: <code>align</code> および <code>useMap</code>。<br> - 次のプロパティが追加されました: <code>autocomplete</code>, <code>autofocus</code>, <code>dirName</code>, <code>files</code>, <code>formAction</code>, <code>formEnctype</code>, <code>formMethod</code>, <code>formNoValidate</code>, <code>formTarget</code>, <code>height</code>, <code>indeterminate</code>, <code>labels</code>, <code>list</code>, <code>max</code>, <code>min</code>, <code>multiple</code>, <code>pattern</code>, <code>placeholder</code>, <code>required</code>, <code>selectionDirection</code>, <code>selectionEnd</code>, <code>selectionStart</code>, <code>step</code>, <code>validationMessage</code>, <code>validity</code>, <code>valueAsDate</code>, <code>valueAsNumber</code>, <code>width</code>, <code>willValidate</code>.<br> - 次のメソッドが追加されました: <code>checkValidity()</code>, <code>setCustomValidity()</code>, <code>setSelectionRange()</code>, <code>stepUp()</code>, <code>stepDown()</code></td> - </tr> - <tr> - <td>{{SpecName('DOM2 HTML', 'html.html#ID-6043025', 'HTMLInputElement')}}</td> - <td>{{Spec2('DOM2 HTML')}}</td> - <td><code>size</code> プロパティが <code>unsigned long</code> になりました。<code>type</code> プロパティはすべて小文字で指定する必要があります。</td> - </tr> - <tr> - <td>{{SpecName('DOM1', 'level-one-html.html#ID-6043025', 'HTMLInputElement')}}</td> - <td>{{Spec2('DOM1')}}</td> - <td>初回定義</td> - </tr> - </tbody> -</table> + - 現在の {{htmlattrxref("type","input")}} の値にこのメソッドが適用できない場合 + - 要素に {{htmlattrxref("step","input")}} 値が設定されていない場合 + - {{htmlattrxref("value","input")}} が数値に変換できない場合 + - 結果の値が {{htmlattrxref("max","input")}} を超えたり、 {{htmlattrxref("min","input")}} を下回ったりする場合 + +- {{domxref("HTMLInputElement.mozSetFileArray()", "mozSetFileArray()")}} {{non-standard_inline}} + - : 入力欄で選択されたファイルを、与えられた {{domxref("File")}} オブジェクトの配列に設定します。これは、フレームスクリプトで使用可能な `mozSetFileNameArray()` の代替となるものです。クロームスクリプトは[ファイルを File オブジェクトとして開き](/ja/docs/Extensions/Using_the_DOM_File_API_in_chrome_code)、[メッセージマネージャー](/ja/docs/Mozilla/Firefox/Multiprocess_Firefox/The_message_manager)を介してそれらを送信することができます。 +- {{domxref("HTMLInputElement.mozGetFileNameArray()", "mozGetFileNameArray()")}} {{non-standard_inline}} + - : その入力欄からすべてのファイル名の配列を返します。 + +## イベント + +以下のイベントは、 [`addEventListener()`](/ja/docs/Web/API/EventTarget/addEventListener) を用いるか、このインターフェイスの `onイベント名` プロパティにイベントリスナーを割り当てるかして待ち受けしてください。 + +- [`input`](/ja/docs/Web/API/HTMLElement/input_event) + - : {{HTMLElement("input")}}、{{HTMLElement("select")}}、{{HTMLElement("textarea")}} のいずれかの要素の `value` が変更されたときに発生します。なお、このイベントは実際には {{domxref("HTMLElement")}} インターフェイス上で発生し、 [`contenteditable`](/ja/docs/Web/HTML/Global_attributes/contenteditable) 要素にも適用されますが、フォーム入力要素で最も一般的に使用されるため、ここに挙げています。 + [`oninput`](/ja/docs/Web/API/GlobalEventHandlers/oninput) イベントハンドラープロパティからも利用できます。 +- [`invalid`](/ja/docs/Web/API/HTMLInputElement/invalid_event) + - : 制約検証時に、要素が制約を満たしていなかった場合に発生します。 + [`oninvalid`](/ja/docs/Web/API/GlobalEventHandlers/oninvalid) イベントハンドラープロパティからも利用できます。 +- [`search`](/ja/docs/Web/API/HTMLInputElement/search_event) + - : {{HTMLElement("input")}} の `type="search"` で検索が開始されたときに発生します。 + [`onsearch`](/ja/docs/Web/API/GlobalEventHandlers/onsearch) イベントハンドラープロパティからも利用できます。 + +## 仕様書 + +{{Specifications}} -<h2 id="Browser_compatibility">ブラウザーの互換性</h2> +## ブラウザーの互換性 -<div> -<p>{{Compat("api.HTMLInputElement")}}</p> -</div> +{{Compat}} -<h2 id="See_also">関連情報</h2> +## 関連情報 -<ul> - <li>このインターフェイスを実装している HTML 要素: {{ HTMLElement("input") }}</li> -</ul> +- このインターフェイスを実装している HTML 要素: {{ HTMLElement("input") }} |