HTMLAreaElement: search 属性

Baseline 已广泛支持

此特性已相当成熟,可在许多设备和浏览器版本上使用。自 ⁨2015 年 7 月⁩以来,各浏览器均已提供此特性。

HTMLAreaElement 接口的 search 属性是一个搜索字符串,也称为查询字符串,它是一个包含 "?" 及其后跟的 <area> 元素的 href 参数的字符串。如果 URL 没有搜索查询,则此属性包含一个空字符串 ""

可以设置此属性来更改 URL 的查询字符串。设置时,如果未提供,则会在提供的值前面添加一个 "?" 前缀。将其设置为空字符串 "" 会删除查询字符串。

查询在设置时会进行百分比编码,但在读取时不会进行百分比解码。

现代浏览器提供了 URLSearchParamsURL.searchParams,可以轻松地从查询字符串中解析出参数。

有关更多信息,请参阅 URL.search

字符串。

示例

js
// An <area id="myArea" href="/en-US/docs/HTMLAreaElement?q=123"> element is in the document
const area = document.getElementById("myArea");
area.search; // returns '?q=123'

使用 URLSearchParams 进行高级解析

或者,也可以使用 URLSearchParams

js
let params = new URLSearchParams(queryString);
let q = parseInt(params.get("q"), 10); // returns the number 123

规范

规范
HTML
# dom-hyperlink-search-dev

浏览器兼容性

另见