萬盛學電腦網

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

jQuery 組件常見問題整理:母版頁引用順序、DataTable 報錯、TableSorter 異常字符

問題 1:ASP.NET 母版頁引入 JS,內容頁報錯「$ 未定義」

原因:母版頁 <head> 中引用 jQuery,但內容頁的 <asp:Content> 渲染位置可能在 jQuery 腳本**之前**,導致內容頁內聯腳本執行時 jQuery 尚未加載。

解決:

  1. 在母版頁 <head> **最頂部**引用 jQuery,確保優先加載。
  2. 內容頁所有腳本放在 <asp:Content ContentPlaceHolderID="ScriptSection"> 專門腳本區塊,該區塊渲染在頁面底部(</body> 前)。
  3. 或使用 ScriptManager / ClientScriptManager.RegisterStartupScript 註冊啟動腳本,保證順序。

問題 2:DataTables 初始化報錯 oCol is Undefined

原因:表格 <thead> 中 <th> 數量與 <tbody> 中 <td> 數量**不一致**(含隱藏列、colspan/rowspan 導致邏輯列數不匹配)。DataTables 核心需要列數嚴格對應。

排查步驟:

  1. 檢查 HTML 結構:$('#table thead th').length === $('#table tbody tr:first td').length。
  2. 若使用 colspan,需在 DataTables 配置中對應 columns 設置 visible: false 或使用 columnDefs。
  3. 動態生成表格時,確保服務端輸出的列數固定。

問題 3:TableSorter (tablesorter.js) 加載失敗,第 908 行異常字符

現象:源碼中出現 £$€ 等特殊字符被 JS 引擎視為非法標識符導致語法錯誤。

原因:文件編碼不一致(UTF-8 源碼被以 ANSI/GBK 讀取),或源碼中混入不可見控制字符。

解決:

  1. 用編輯器(VS Code/Notepad++)以 **UTF-8 without BOM** 重新保存 jquery.tablesorter.js。
  2. 或直接刪除/替換該行異常字符(通常在註釋或正則字面量中)。
  3. 建議改用現代維護中的分支(如 Mottie/tablesorter),原版已停更多年。

通用最佳實踐

  • 腳本加載順序:jQuery → 插件 → 業務代碼。用模塊打包器自動管理依賴。
  • 編碼統一:項目所有文件統一 UTF-8,HTML 聲明 <meta charset="utf-8">,服務端響應頭 Content-Type: text/html; charset=utf-8。
  • 錯誤定位:瀏覽器 DevTools Console 點擊報錯行號,查看源碼上下文,多為編碼/順序/列數不匹配等低級問題。
copyright © 萬盛學電腦網 all rights reserved