用 jQuery 操作 DOM 比原生 API 簡潔得多,且介面統一,學習成本低。以下依主題整理。
// 設定單一樣式
$(selector).css("color", "red");
// 設定多樣式
$(selector).css({ "color": "red", "font-size": "30px" });
// 讀取樣式
$(selector).css("font-size");
$(selector).addClass("liItem"); // 新增類(類名不帶點)
$(selector).removeClass("liItem"); // 移除類
$(selector).removeClass(); // 不傳參數:移除全部類
$(selector).hasClass("liItem"); // 判斷是否含類,回傳布林值
$(selector).toggleClass("liItem"); // 有則移除、無則新增
注意:所有類操作方法都不帶點(.)。
選 css() 還是 class 操作?樣式少就用 css();樣式多就用類;若考慮後續維護(把 CSS 從 JS 中分離出來),一律優先用類,這與「把 CSS 從 HTML 中分離出來」是同一個道理。
$(selector).show(2000); // 毫秒數
$(selector).show("slow"); // slow=600ms、normal=400ms、fast=200ms
$(selector).show(2000, function () {}); // 第二參數為完成後的回呼
$(selector).show(); // 無參數,等同 css("display", "block"),沒有動畫
$(selector).hide(1000);
$(selector).hide("slow");
$(selector).hide(1000, function () {});
$(selector).hide();
jQuery 預設的三組動畫語法幾乎一致:第一個參數是時長,第二個是完成後的回呼。
$(selector).slideDown(speed, callback); // 由上往下展開 $(selector).slideUp(speed, callback); // 由上往上收起 $(selector).slideToggle(speed, callback); // 切換
省略參數或傳入不合法字串時,會使用預設的 400 毫秒。
$(selector).fadeIn(speed, callback);
$(selector).fadeOut(1000);
$(selector).fadeToggle('fast', function () {});
// fadeTo:指定精確的不透明度,第一個參數為時長(必填),第二個為 0~1 的值
$(selector).fadeTo(1000, .5);
$(selector).fadeTo(0, .5); // 時長為 0 時等同 css("opacity", .5)
fadeTo 與 fadeIn 的差別:淡入淡出只能在水準 0 與 1 之間移動,fadeTo 可以停在任意中間值。
這些動畫實際控制的 CSS 屬性只有三個:height、width、opacity。它們的共同特徵是屬性值只有一個,且去掉單位後是數值。
$(selector).animate({ params }, speed, callback);
所有能執行動畫的屬性必須是單一數值。例如要改字級,要寫 fontSize,不能寫 font(複合屬性)。
支援的屬性清單:https://www.w3school.com.cn/jquery/effect_animate.asp
若同一元素被連續呼叫多個動畫方法,後者會被放進效果佇列排隊,等前一個播完才開始。這會造成滑鼠快速滑過時動畫「追不上」的窘境。
$(selector).stop(clearQueue, jumpToEnd); $(selector).stop(); // 常用寫法
參數說明:
clearQueue = true:刪除佇列中剩餘的動畫,它們將永遠不會執行。jumpToEnd = true:立即把目前的動畫跳到最終狀態(例如 slideUp 就直接隱藏),並立刻執行回呼。重要:動畫若中途被 stop() 中止,其完成回呼不會被執行。別把關鍵的後續邏輯只寫在動畫回呼裡。
var $spanNode = $("<span>我是一個 span 元素</span>");
$(selector).append($node); // 在內部最後一個子元素之後插入
$(selector).append('<div></div>'); // 參數也可為 HTML 字串
$(selector).appendTo(node); // 方向相反:把自己追加到 node 中
$(selector).prepend(node); // 插入到內部第一個子元素之前
$(selector).after(node); // 作為兄弟插在後面
$(selector).before(node); // 作為兄弟插在前面
若被追加的元素本來就在頁面上,append() 會把它從原位置移走而非複製。若目標有多個,內部會複製多份,這種情況應盡量避免。
$(selector).html('<span>大方啊</span>'); // 寫入標籤即動態建立元素
$(selector).html(); // 讀取 HTML 內容
$(selector).empty(); // 清空所有子元素,自己留下
$(selector).html(""); // 等效寫法
$(selector).remove(); // 把自己連同內部內容一起從文件移除
$(selector).clone();
$(selector).attr("title", "小花啊"); // 設定屬性
$(selector).attr("title"); // 讀取屬性
$(selector).removeAttr("title"); // 移除屬性
$(selector).val(); // 讀取表單值(只取第一個匹配元素)
$(selector).val("具體值"); // 為所有匹配元素設值
$(selector).text(); // 讀取文字(會把所有匹配元素的內容拼成一個字串)
$(selector).text("我是內容"); // 設定文字
checked、selected、disabled 一律用 prop()。prop 影響的是 DOM 元素的動態狀態,而非 HTML 標籤上的初始屬性。詳見 https://api.jquery.com/prop/
$(selector).height(200); // 設定高度
$(selector).height(); // 取得高度,回傳數值
$(selector).width(200);
$(selector).width();
$(selector).offset(); // 取得座標,回傳 {left: num, top: num}
$(selector).offset({ left: 100, top: 150 }); // 設定座標
offset 的隱藏行為:設定座標時,若元素沒有定位(預設 static),jQuery 會自動把它改成 relative。
$(selector).scrollTop(100); // 設定垂直捲動位置 $(selector).scrollTop(); // 讀取 $(selector).scrollLeft(100); // 水平方向同理
scrollTop 的含義:垂直捲動條位置等於「可捲動區域位於可視區域上方、被隱藏起來的那段高度」。若捲動條在最頂端未捲動,或元素根本沒有捲動條,這個值為 0。