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() 會在網站上選擇(高亮顯示)找到的內容。

規範

這不屬於任何規範。

瀏覽器相容性