HTMLInputElement: search イベント

非標準: この機能は標準ではなく、標準化の予定もありません。公開されているウェブサイトには使用しないでください。ユーザーによっては使用できないことがあります。実装ごとに大きな差があることもあり、将来は振る舞いが変わるかもしれません。

search イベントは、 <input> 要素の type="search" にて検索が開始されたときに発生します。

バブリング	はい
キャンセル	不可
インターフェイス	`Event`
イベントハンドラープロパティ	`onsearch`

検索を開始する方法はいくつかあり、例えば、 <input> にフォーカスがある時に Enter を押したり、incremental 属性が存在すれば、最も新しいキー入力から UA 定義のタイムアウト時間が経過してから検索が開始されます（新しくキー入力をするとタイムアウトがリセットされるので、イベントが繰り返して発生します）。

現在 UA が <input type="search"> を実装している方法では、フィールド内をクリアするために追加のコントロールを置きます。このコントロールを使用しても search イベントが発生します。この場合、 <input> 要素の value は空文字列になります。

例

// addEventListener 版
const input = document.querySelector('input[type="search"]');

input.addEventListener('search', () => {
 console.log("The term searched for was " + input.value);
})

// onsearch 版
const input = document.querySelector('input[type="search"]');

input.onsearch = () => {
 console.log("The term searched for was " + input.value);
})

仕様書

このイベントは仕様書に含まれていません。

ブラウザーの互換性

BCD tables only load in the browser