このページはコミュニティーの尽力で英語から翻訳されました。MDN Web Docsコミュニティーについてもっと知り、仲間になるにはこちらから。
HTMLAreaElement: search プロパティ
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since 2015年7月.
search はHTMLAreaElement インターフェイスのプロパティで、検索文字列、またの名をクエリー文字列、"?" に続いて<area> 要素のhref の引数を含む文字列です。URL に検索クエリーがない場合、このプロパティには空文字列 ("") が入ります。
このプロパティを設定して、 URL のクエリ文字列を変更することができます。設定すると、指定された値に、まだ存在しない場合は 1 つの"?" 接頭辞が追加されます。このプロパティを"" に設定すると、クエリー文字列が除去されます。
クエリーは、設定時にはパーセントエンコードされますが、読み取り時にはパーセントデコードされません。
最新のブラウザーでは、URLSearchParams とURL.searchParams を提供して、クエリー文字列から引数を簡単に解析できるようにしています。
詳しくはURL.search を参照してください。
値
文字列です。
例
エリアのリンクから検索文字列を取得
js
// <area href="/ja/docs/HTMLAreaElement?q=123"> 要素が文書内にあったとしますconst area = document.getElementById("myArea");area.search; // '?q=123' を返すURLSearchParams を使用した高度な解釈
他にも、URLSearchParams が使われる場面があります。
js
let params = new URLSearchParams(queryString);let q = parseInt(params.get("q")); // 数値 123 を返す仕様書
| Specification |
|---|
| HTML # dom-hyperlink-search-dev |
ブラウザーの互換性
関連情報
- 所属先の
HTMLAreaElementインターフェイス