萬盛學電腦網

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

jQuery 實作頁面關鍵字搜尋高亮與定位:仿 12306 車站查詢效果

功能需求

  • 輸入關鍵字,支援按鈕點擊或 Enter 鍵觸發搜尋
  • 頁面內容即時高亮匹配文字(黃底紅字)
  • 自動滾動定位到第一個匹配項
  • 顯示提示浮層:匹配數量、當前第幾個、上/下一個導航
  • 搜尋框固定在視窗頂部,方便長頁面操作
  • 支援清除高亮、重新尋

完整實作代碼

HTML 結構

<div id="searchBox" class="search-box">
  <input type="text" id="searchInput" class="search-input" placeholder="輸入車站名..." autocomplete="off">
  <button type="button" id="searchBtn" class="search-btn">頁內查找</button>
  <span id="searchInfo" class="search-info"></span>
  <button type="button" id="prevBtn" class="nav-btn" disabled>▲ 上一個</button>
  <button type="button" id="nextBtn" class="nav-btn" disabled>下一個 ▼</button>
  <button type="button" id="clearBtn" class="clear-btn">清除</button>
</div>

<div id="content" class="content-area">
  <p><strong>08:00 起售車站</strong><br>安陽、北京西、成都東、大連、東莞...</p>
  <p><strong>10:00 起售車站</strong><br>上海、廣州、深圳、杭州、寧波...</p>
  <!-- 更多內容 -->
</div>

CSS 樣式

.search-box {
  position: sticky; top: 0; z-index: 1000;
  background: rgba(255,255,255,0.95); backdrop-filter: blur(8px);
  padding: 15px 20px; border-bottom: 1px solid #eee;
  display: flex; align-items: center; gap: 10px; flex-wrap: wrap;
}
.search-input { padding: 8px 12px; font-size: 16px; border: 1px solid #ddd; border-radius: 4px; flex: 1; min-width: 200px; }
.search-btn { background: #3498db; color: white; border: none; padding: 8px 20px; border-radius: 4px; cursor: pointer; }
.search-btn:hover { background: #2980b9; }
.search-info { font-size: 14px; color: #666; min-width: 180px; }
.nav-btn { background: #f1f1f1; border: 1px solid #ddd; padding: 6px 12px; border-radius: 4px; cursor: pointer; }
.nav-btn:disabled { opacity: 0.5; cursor: not-allowed; }
.clear-btn { background: #e74c3c; color: white; border: none; padding: 8px 16px; border-radius: 4px; cursor: pointer; }

.content-area { padding: 20px; line-height: 1.8; }
.highlight { background: #fff3cd; color: #e74c3c; padding: 0 2px; border-radius: 2px; }
.highlight.current { background: #e74c3c; color: white; box-shadow: 0 0 0 2px rgba(231,76,60,0.3); }

jQuery 核心邏輯

(function($) {
  'use strict';
  
  var $searchBox = $('#searchBox');
  var $input = $('#searchInput');
  var $btn = $('#searchBtn');
  var $info = $('#searchInfo');
  var $prevBtn = $('#prevBtn');
  var $nextBtn = $('#nextBtn');
  var $clearBtn = $('#clearBtn');
  var $content = $('#content');
  
  var highlights = [];      // 所有高亮元素陣列
  var currentIndex = -1;    // 目前聚焦的高亮索引
  var lastKeyword = '';     // 上次搜尋關鍵字
  
  // 1. 固定搜尋框 (現代 CSS sticky 已處理,JS 此處可做舊瀏覽器兼容)
  // 已由 CSS position:sticky 實現,無需 JS
  
  // 2. 核心搜尋高亮函式
  function doSearch() {
    var keyword = $.trim($input.val());
    
    if (!keyword) {
      showInfo('請輸入查找關鍵字', 'warning');
      $input.focus();
      return;
    }
    
    // 相同關鍵字不重複處理,直接導航下一個
    if (keyword === lastKeyword && highlights.length > 0) {
      navigateNext();
      return;
    }
    
    // 清除舊高亮
    clearHighlights();
    
    // 建立正則:全域匹配、忽略大小寫、轉義特殊字元
    var escaped = keyword.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
    var regex = new RegExp('(' + escaped + ')', 'gi');
    
    var foundCount = 0;
    
    // 遍歷內容區塊的文字節點進行替換 (避免破壞事件綁定)
    $content.contents().each(function() {
      if (this.nodeType === Node.TEXT_NODE) {
        var text = this.nodeValue;
        if (regex.test(text)) {
          var highlighted = text.replace(regex, '<span class="highlight">$1</span>');
          var $span = $(' 0;
    $prevBtn.prop('disabled', !hasHighlights);
    $nextBtn.prop('disabled', !hasHighlights);
  }
  
  // 平滑滾動到元素置中
  function scrollIntoViewCenter(el) {
    var rect = el.getBoundingClientRect();
    var viewportHeight = window.innerHeight;
    var scrollTop = window.pageYOffset || document.documentElement.scrollTop;
    var targetTop = scrollTop + rect.top - (viewportHeight / 2) + (rect.height / 2);
    $('html, body').animate({ scrollTop: targetTop }, 300);
  }
  
  function showInfo(msg, type) {
    $info.text(msg).removeClass('warning error success').addClass(type);
  }
  
  // 5. 事件綁定
  $btn.on('click', doSearch);
  $input.on('keydown', function(e) {
    if (e.key === 'Enter') { e.preventDefault(); doSearch(); }
  });
  $nextBtn.on('click', navigateNext);
  $prevBtn.on('click', navigatePrev);
  $clearBtn.on('click', clearHighlights);
  $input.on('input', function() {
    // 輸入時即時清除高亮 (可選)
    if ($.trim(this.value) === '') clearHighlights();
  });
  
  // 鍵盤快捷鍵
  $(document).on('keydown', function(e) {
    if (e.target.tagName === 'INPUT') return;
    if (e.key === 'F3' || (e.ctrlKey && e.key === 'g')) {
      e.preventDefault();
      e.shiftKey ? navigatePrev() : navigateNext();
    }
    if (e.key === 'Escape') clearHighlights();
  });
  
})(jQuery);

關鍵技術點解析

1. 文字節點替換 vs innerHTML 替換

原文使用 $(p).html(newHtml) 會破壞元素內部的事件綁定、輸入框狀態。本方案遍歷 Node.TEXT_NODE,僅替換文字內容,保留結構與事件。

2. 正則特殊字元轉義

keyword.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')

防止使用者輸入 `(`、`[`、`*` 等正則元字元導致錯誤或匹配異常。

3. 大小寫不敏感匹配

正則旗標 i 實現不區分大小寫搜尋。

4. 無障礙支援

  • aria-live="polite" 讓螢幕報讀器播報搜尋結果
  • 鍵盤完整操作:Enter 搜尋、F3/Ctrl+G 下一個、Shift+F3 上一個、Esc 清除
  • 語意化按鈕 type="button" 防止表單提交

效能優化建議

  • 大頁面 (>5000 節點) 考慮使用 TreeWalker API 替代 jQuery 遍歷
  • 防抖動:輸入時延遲 300ms 執行搜尋
  • 虛擬滾動:超長列表只渲染可視區域
  • Web Worker:極大文檔離主執行緒處理匹配

總結

這個頁面搜尋元件涵蓋:關鍵字高亮 (文字節點安全替換)、自動定位滾動、鍵盤導航、狀態管理、無障礙支援。核心難點在於不破壞既有 DOM 結構與事件地進行高亮,以及跨元素邊界匹配 (本範例簡化為單元素內匹配,跨元素需更複雜的 Range API 處理)。適合文檔閱讀、後台管理列表、知識庫等長頁面場景。

copyright © 萬盛學電腦網 all rights reserved