在網頁中實作一個可拖曳的搜尋面板,支援關鍵字輸入、下一個/上一個導航、高亮顯示匹配文字,模擬瀏覽器原生 Ctrl+F 的行為。
現代瀏覽器主要使用 window.find() (Firefox/Chrome/Safari) 與 TextRange (舊版 IE) 兩套機制。
function findInPage(str) {
if (!str) return false;
// 現代瀏覽器 (Firefox, Chrome, Safari, Edge)
if (window.find) {
// window.find 回傳是否找到,第三參數為向後搜尋
if (!window.find(str, false, true)) {
// 從頭再找一次
window.find(str, false, true);
}
return true;
}
// 舊版 IE (IE4-IE10) 使用 TextRange
if (document.body.createTextRange) {
const txt = document.body.createTextRange();
let found = false;
// 迴圈尋找所有匹配
while (txt.findText(str)) {
txt.moveStart("character", 1);
txt.moveEnd("textedit");
found = true;
}
if (found) {
txt.moveStart("character", -1);
txt.findText(str);
txt.select();
txt.scrollIntoView();
return true;
}
}
return false;
}
使用 mousedown/mousemove/mouseup 事件實作拖曳,並記錄初始座標計算位移。
let dragApproved = false;
let dragTarget = null;
let startX, startY, initLeft, initTop;
function onMouseDown(e) {
const target = e.target.closest(".drag-handle");
if (!target) return;
dragTarget = target.closest(".search-panel");
dragApproved = true;
startX = e.clientX;
startY = e.clientY;
initLeft = dragTarget.offsetLeft;
initTop = dragTarget.offsetTop;
document.addEventListener("mousemove", onMouseMove);
document.addEventListener("mouseup", onMouseUp);
}
function onMouseMove(e) {
if (!dragApproved || !dragTarget) return;
const dx = e.clientX - startX;
const dy = e.clientY - startY;
dragTarget.style.left = (initLeft + dx) + "px";
dragTarget.style.top = (initTop + dy) + "px";
}
function onMouseUp() {
dragApproved = false;
dragTarget = null;
document.removeEventListener("mousemove", onMouseMove);
document.removeEventListener("mouseup", onMouseUp);
}
document.addEventListener("mousedown", onMouseDown);
搜尋到文字後,瀏覽器原生 API 會自動選取並捲動至可視區域。若需自訂高亮樣式,可結合 Selection API 與 Range 包裝匹配文字節點。
function highlightAll(keyword) {
if (!keyword) return;
// 移除舊高亮
document.querySelectorAll(".search-highlight").forEach(el => {
el.outerHTML = el.innerHTML;
});
const walker = document.createTreeWalker(document.body, NodeFilter.SHOW_TEXT);
const regex = new RegExp(keyword.replace(/[.*+?^${}()|[\]\\]/g, "\\$&"), "gi");
const nodesToWrap = [];
while (walker.nextNode()) {
const node = walker.currentNode;
if (node.parentNode.closest(".search-panel")) continue; // 排除搜尋面板本身
if (regex.test(node.nodeValue)) {
nodesToWrap.push(node);
}
}
nodesToWrap.forEach(node => {
const frag = document.createDocumentFragment();
let lastIndex = 0;
node.nodeValue.replace(regex, (match, offset) => {
frag.appendChild(document.createTextNode(node.nodeValue.slice(lastIndex, offset)));
const mark = document.createElement("mark");
mark.className = "search-highlight";
mark.textContent = match;
frag.appendChild(mark);
lastIndex = offset + match.length;
});
frag.appendChild(document.createTextNode(node.nodeValue.slice(lastIndex)));
node.parentNode.replaceChild(frag, node);
});
}
以下為一個可直接執行的簡化版本,包含搜尋輸入、導航按鈕、可拖曳面板與高亮效果:
<!DOCTYPE html>
<html lang="zh-Hant">
<head>
<meta charset="UTF-8">
<title>網頁關鍵字搜尋 Demo</title>
<style>
.search-panel {
position: fixed; top: 20px; right: 20px; z-index: 9999;
background: #fff; border: 1px solid #ddd; border-radius: 4px;
padding: 10px; box-shadow: 0 2px 10px rgba(0,0,0,0.1);
font-family: sans-serif; min-width: 260px;
}
.drag-handle { cursor: move; background: #f0f0f0; margin: -10px -10px 10px; padding: 5px 10px; border-bottom: 1px solid #ddd; }
.search-input { width: 70%; padding: 5px; border: 1px solid #ccc; border-radius: 3px; }
.search-btn { padding: 5px 10px; background: #007bff; color: #fff; border: none; border-radius: 3px; cursor: pointer; margin-left: 5px; }
.search-btn:hover { background: #0056b3; }
mark.search-highlight { background: #ff0; padding: 0 2px; border-radius: 2px; }
mark.search-highlight.current { background: #f80; }
</style>
</head>
<body>
<h1>文章標題</h1>
<p>這是一段範例文字,用於測試關鍵字搜尋與高亮功能。關鍵字可以是「測試」、「功能」或「文字」。</p>
<p>另一段內容,包含重複的關鍵字:測試、測試、測試。</p>
<div class="search-panel" id="panel">
<div class="drag-handle">🔍 搜尋面板 (可拖曳)</div>
<input type="text" class="search-input" id="kw" placeholder="輸入關鍵字">
<button class="search-btn" onclick="doSearch()">搜尋下一個</button>
<button class="search-btn" onclick="doSearch(true)">搜尋上一個</button>
<button class="search-btn" onclick="clearHighlight()" style="background:#6c757d;">清除高亮</button>
</div>
<script>
let lastSearch = "";
let searchRanges = [];
let currentIndex = -1;
// 拖曳邏輯 (同上)
function doSearch(prev = false) {
const kw = document.getElementById("kw").value.trim();
if (!kw) return alert("請輸入關鍵字");
if (kw !== lastSearch) {
// 新關鍵字:重新掃描全文
lastSearch = kw;
searchRanges = [];
currentIndex = -1;
highlightAll(kw);
// 收集所有高亮元素
searchRanges = Array.from(document.querySelectorAll("mark.search-highlight"));
}
if (searchRanges.length === 0) return alert("找不到匹配內容");
// 移除舊 current 標記
if (currentIndex >= 0) searchRanges[currentIndex].classList.remove("current");
// 計算下一個索引
if (prev) {
currentIndex = (currentIndex - 1 + searchRanges.length) % searchRanges.length;
} else {
currentIndex = (currentIndex + 1) % searchRanges.length;
}
const target = searchRanges[currentIndex];
target.classList.add("current");
target.scrollIntoView({ behavior: "smooth", block: "center" });
}
function clearHighlight() {
document.querySelectorAll("mark.search-highlight").forEach(el => {
el.outerHTML = el.innerHTML;
});
lastSearch = "";
searchRanges = [];
currentIndex = -1;
}
// 拖曳事件綁定 (同上)
</script>
</body>
</html>
若專案允許使用現代 API,建議採用 window.find() 結合 Selection API,或使用成熟函式庫如 Mark.js 處理複雜的高亮與跨節點匹配。
本文從底層 TextRange 到現代 window.find,再到自訂高亮與可拖曳 UI,完整展示了實作網頁內搜尋功能的演進路徑。理解這些機制有助於在無法使用瀏覽器原生搜尋的嵌入式場景(如 WebView、Electron、離線文檔)中提供一致的使用者體驗。