萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

JavaScript 實作網頁關鍵字搜尋與高亮功能(類瀏覽器內建搜尋)

功能需求

在網頁中實作一個可拖曳的搜尋面板,支援關鍵字輸入、下一個/上一個導航、高亮顯示匹配文字,模擬瀏覽器原生 Ctrl+F 的行為。

核心實作邏輯

1. 跨瀏覽器文字搜尋 API

現代瀏覽器主要使用 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;
}

2. 可拖曳搜尋面板

使用 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);

3. 高亮顯示與導航

搜尋到文字後,瀏覽器原生 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、離線文檔)中提供一致的使用者體驗。

copyright © 萬盛學電腦網 all rights reserved