要開始用 jQuery,只要在 HTML 中引入函式庫即可:
<script language="javascript" src="/js/jquery.min.js"></script>
檔案可以放本地,也可以直接用大廠的 CDN。用 CDN 有兩個好處:一是這些服務太普遍,使用者往往早已快取過同一份檔案,載入幾乎是免費的;二是省下自己網站的流量與頻寬。
以下把最常見的十種操作並列對照,順便指出幾個該注意的差異。
// JS
document.getElementById("abc")
// jQuery
$("#abc") // 依 id
$(".abc") // 依 class
$("div") // 依標籤
關鍵差異:JS 回傳的是那個 DOM 元素本身,jQuery 回傳的是一個包含它的 jQuery 物件。 這也是為什麼 jQuery 能一路串接呼叫,而原生元素不行。要在兩者間轉換:$domEl 包成 jQuery,$jqObj[0] 或 $jqObj.get(0) 取回原生元素。
abc.innerHTML = "test"; // JS
abc.html("test"); // jQuery
若內容含使用者的輸入,jQuery 有 .text() 會自動轉義,比 html() 安全。
abc.style.display = "none"; // JS
abc.style.display = "block"; // JS
abc.hide(); // jQuery
abc.show();
abc.toggle(); // 在顯示與隱藏間切換
hide()/show() 會記住元素原本的 display 值再還原,比手寫 block 更不容易破壞排版。
兩邊一樣:abc.focus();
abc.value = "test"; // JS
abc.val("test"); // jQuery
alert(abc.value); // JS
alert(abc.val()); // jQuery
注意 jQuery 的 val() 有沒有帶參數是兩種行為:帶參數是設定,不帶是讀取。這是 jQuery API 設計的一貫風格。
abc.disabled = true; // JS
abc.attr("disabled", true); // jQuery(舊寫法)
abc.prop("disabled", true); // jQuery 1.6+ 建議寫法
這裡要特別注意:布林狀態(disabled、checked、selected)該用 prop() 而非 attr(),因為 attr() 對應的是 HTML 標籤上的文字,並非元素當下的實際狀態。用錯會導致跨瀏覽器行為不一致。
abc.style.fontSize = size; // JS
abc.css('font-size', 20); // jQuery
abc.className = "test"; // JS
abc.removeClass(); // jQuery
abc.addClass("test");
jQuery 的 css() 第二參數若傳數字會自動補上 px(opacity、z-index 等無單位屬性除外)。相較之下 addClass/removeClass 能保留既有的其他 class,比直接覆寫 className 安全得多。
// JS:自己建立物件、自己處理跨瀏覽器差異(略)
// jQuery
$.get("abc.php?a=1&b=2", recall);
var postvalue = "a=b&c=d&abc=123";
$.post("abc.php", postvalue, recall);
function recall(result) {
alert(result);
// 若回傳的是 json:
// result = eval('(' + result + ')');
}
這一項是 jQuery 早期最大的賣點,省下大量相容性程式碼。今日則可直接用 fetch 或 XMLHttpRequest;若用 jQuery,記得 不要用 eval 解析 JSON,改用 $.parseJSON() 或指定 dataType: "json" 讓 jQuery 自己處理。eval 會執行字串中的任意程式碼,是明確的 XSS 風險。
if (abc.attr("checked") == "checked") // 舊寫法,不可靠
if (abc.prop("checked")) // 建議寫法
if (abc.is(":checked")) // 也可以
這是最典型的 attr/prop 陷阱。attr("checked") 讀的是「當初 HTML 裡有沒有寫 checked 這個字」,而不是「使用者現在有沒有勾」,兩者在互動之後就會分歧。
我的建議是兩個都要會。原生 API 現在已經很好用:querySelector、classList、fetch、addEventListener 幾乎覆蓋了 jQuery 當年解決的所有痛點,而且不必多載一個函式庫。jQuery 的優勢則在於極簡的鏈式語法、成熟的插件生態,以及維護既有專案時的必然性。理解兩者的對應關係(如本文的對照表),既能讀懂老程式碼,也能在新專案裡做出合適的選擇。