1. 開発者向けのウェブ技術
  2. Web API
  3. Element
  4. input

このページはコミュニティーの尽力で英語から翻訳されました。MDN Web Docs コミュニティーについてもっと知り、仲間になるにはこちらから。

View in English Always switch to English

Element: input イベント

Baseline 広く利用可能

この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2020年1月以降、すべてのブラウザーで利用可能です。

input イベントは、 <input>, <select>, <textarea> の各要素の値 (value) が、ユーザーのアクション（テキストボックスに入力したり、チェックボックスを調べるなど）を直接的な原因変更された際に発行されます。

このイベントは、 contenteditable を有効にした要素、 designMode を有効にしたすべての要素にも適用されます。 contenteditable や designMode の場合、イベントのターゲットは編集ホストです。これらのプロパティが複数の要素に適用された場合、編集ホストは親が編集可能ではない直近の祖先要素になります。

<input> 要素が type=checkbox または type=radio 型であった場合、 HTML Living Standard 仕様書によれば、 input イベントはユーザーがコントロールの状態を変更するたびに発生することになっています。しかし、歴史的に常にそうなるとは限りません。互換性に注意するか、これらの種類の要素では、代わりに change イベントを使用するようにするかしてください。

<textarea> およびテキスト入力を受け入れる <input> 要素（type=text、type=tel、など）では、インターフェイスは InputEvent です。それ以外の場合は、インターフェイスは Event になります。

input イベントは、要素の value の値が変化するたびに発生します。これは、 change イベントが Enter キーが押されたり、選択肢から値が選択されたりするような、値が決定したときに発生するのとは異なります。 JavaScript でプログラムにより要素の value を変更した場合、input イベントは発行されないことに注意してください。

構文

このイベント名を addEventListener() 等のメソッドで使用するか、イベントハンドラープロパティを設定するかしてください。

js
addEventListener("input", (event) => {});

oninput = (event) => {};

イベント型

InputEvent です。UIEvent を継承しています。

Event UIEvent InputEvent

イベントプロパティ

このインターフェイスは、親である UIEvent、Event のプロパティを継承しています。

InputEvent.data 読取専用

文字列で、挿入された文字を返します。変更により挿入されたテキストがない（例えば文字を削除した）場合は、空文字列になることがあります。

InputEvent.dataTransfer 読取専用

編集可能なコンテンツに追加されたリッチテキストまたはプレーンテキストデータ、あるいは削除されたプレーンテキストデータに関する情報を保持する DataTransfer オブジェクトを返します。

InputEvent.inputType 読取専用

テキストの挿入、削除、書式設定など、編集可能なコンテンツに対する変更の種類を返します。

InputEvent.isComposing 読取専用

論理値で、イベントが compositionstart の後かつ compositionend の前に発生したかを示す値を返します。

例

この例では、 <input> 要素の値が変化するたびに値をログ出力します。

HTML

html
<input placeholder="Enter some text" name="name" />
<p id="values"></p>

JavaScript

js
const input = document.querySelector("input");
const log = document.getElementById("values");

input.addEventListener("input", updateValue);

function updateValue(e) {
  log.textContent = e.target.value;
}

結果

仕様書

仕様書
UI Events
# event-type-input
HTML
# handler-oninput

ブラウザーの互換性

関連情報

MDN の改良に協力

協力方法を知る

このページは MDN の貢献者によって に最終更新されました。

GitHub でこのページを表示 • このコンテンツに関する問題を報告