Window：find() 方法

非标准: 该特性是非标准的，请尽量不要在生产环境中使用它！

备注：未来版本的 Gecko 对 Window.find() 的支持可能会发生变化。参见 Firefox bug 672395。

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

语法

find(aString, aCaseSensitive, aBackwards, aWrapAround, aWholeWord, aSearchInFrames, aShowDialog)

参数

aString: 将要搜索的文本字符串。
aCaseSensitive: 布尔值，如果为 true，表示区分大小写搜索。
aBackwards: 布尔值。如果为 true，表示从后往前搜索。
aWrapAround: 布尔值。如果为 true，表示循环搜索。
aWholeWord: 布尔值。如果为 true，表示全词搜索。
aSearchInFrames: 布尔值。如果为 true，表示在框架（frame）中搜索。
aShowDialog: 布尔值。如果为 true，则会弹出一个搜索对话框。

返回值

如果找到指定的字符串，则返回 true，否则返回 false。

示例

JavaScript

function findString(text) {
  document.querySelector("#output").textContent = `找到了字符串？${window.find(
    text,
  )}`;
}

HTML

html

<p>苹果、香蕉和橙子。</p>
<button type="button" onClick='findString("苹果")'>搜索苹果</button>
<button type="button" onClick='findString("香蕉")'>搜索香蕉</button>
<button type="button" onClick='findString("橙子")'>搜索橙子</button>

<p id="output"></p>

结果

备注

在某些浏览器中，Window.find() 会选择（高亮）找到的内容。

规范

不属于任何规范。

浏览器兼容性

BCD tables only load in the browser