Window: find() 方法

非标准:此特性未标准化。我们不建议在生产环境中使用非标准特性,因为它们浏览器支持有限,并且可能会更改或被移除。但是,在没有标准选项的特定情况下,它们可以是合适的替代方案。

注意:Window.find() 的支持情况在 Gecko 的未来版本中可能会发生变化。请参阅 Firefox bug 672395

Window.find() 方法可顺序查找窗口中的字符串。

语法

js
find(string, caseSensitive, backwards, wrapAround, wholeWord, searchInFrames, showDialog)

参数

string

要搜索的文本字符串。

caseSensitive

一个布尔值。如果为 true,则指定区分大小写的搜索。

backwards

一个布尔值。如果为 true,则指定向后搜索。

wrapAround

一个布尔值。如果为 true,则指定循环搜索。

wholeWord

一个布尔值。如果为 true,则指定全词搜索。

searchInFrames

一个布尔值。如果为 true,则指定在框架中搜索。

showDialog

一个布尔值。如果为 true,则显示搜索对话框。

返回值

如果找到字符串,则为 true;否则为 false

示例

HTML

html
<p>Apples, Bananas, and Oranges.</p>
<button type="button" id="find-apples">Search for Apples</button>
<button type="button" id="find-bananas">Search for Bananas</button>
<button type="button" id="find-orange">Search for Orange</button>
<p id="output"></p>

JavaScript

js
function findString(text) {
  document.querySelector("#output").textContent = `String found? ${window.find(
    text,
  )}`;
}

document.getElementById("find-apples").addEventListener("click", () => {
  findString("Apples");
});
document.getElementById("find-bananas").addEventListener("click", () => {
  findString("Bananas");
});
document.getElementById("find-orange").addEventListener("click", () => {
  findString("Orange");
});

结果

注意

在某些浏览器中,Window.find() 会在网站上选择(高亮显示)找到的内容。

规范

这不属于任何规范。

浏览器兼容性