jQuery 的選擇器雖然豐富,總還是會遇到無法表達的條件。這時 $.expr 就派上用場——它讓你能註冊自訂的偽類別選擇器,把常用的判斷邏輯包成一個語法糖。
需求:選出所有「帶有某個 data 鍵值」的元素。
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8" />
<title></title>
<link type="text/css" href="../../themes/base/jquery.ui.all.css" rel="stylesheet" />
<script type="text/javascript" src="../../jquery-1.4.2.js"></script>
<script type="text/javascript" src="../../external/jquery.bgiframe-2.1.1.js"></script>
<script type="text/javascript" src="../../ui/jquery.ui.core.js"></script>
<script type="text/javascript" src="../../ui/jquery.ui.widget.js"></script>
<script type="text/javascript" src="../../ui/jquery.ui.mouse.js"></script>
<script type="text/javascript" src="../../ui/jquery.ui.draggable.js"></script>
<script type="text/javascript" src="../../ui/jquery.ui.position.js"></script>
<script type="text/javascript" src="../../ui/jquery.ui.resizable.js"></script>
<script type="text/javascript" src="../../ui/jquery.ui.dialog.js"></script>
<link type="text/css" href="../demos.css" rel="stylesheet" />>
<script type="text/javascript">
$(function() {
// 初始測試數據
var init = function(){
$("#con1").add("#con3").data("key", "10001");
};
init();
var select = "mytest";
var name = "key";
// 定義一個新選擇器
$.expr[ ":" ][ select ] = function( elem ) {
return !!$.data( elem, name );
};
// 使用
$("div:mytest").each(function(){
alert(this.id); // 結果:con1、con3
})
});
</script>
</head>
<body>
<div id="con1"></div>
<div id="con2"></div>
<div id="con3"></div>
</body>
</html>
那段註冊的語法 $.expr[":"][select] = function(elem){ ... } 做了三件事:
1. 決定選擇器形式:寫進 $.expr[":"] 底下,代表它會成為一個偽類別,使用時要寫成 :mytest。相對地,若註冊在 $.expr["."] 或 $.expr["["] 等位置,就分別對應 class 與 attribute 的語法形式。
2. 接收元素、回傳布林:jQuery 會對每個候選元素呼叫這個函式一次,回傳 true 就保留、false 就剔除。函式中的 elem 是原生 DOM 元素。
3. 用 !! 統一轉型:!!$.data(elem, name) 把 $.data() 的回傳值(可能是 undefined 或實際資料)轉為乾淨的布林值。
於是 $("div:mytest") 就選出了 con1 與 con3——因为只有它們被設定了 key 這個 data 鍵。
上面的例子把判斷條件寫死成 name = "key"。若要讓選擇器接受參數,可以改用這種形式:
$.expr[":"].hasDataKey = function(elem, index, match){
// match[3] 是括號內的參數內容
var key = match[3];
return !!$.data(elem, key);
};
// 使用
$("div:hasDataKey(key)");
如此一來,同一個選擇器就能檢查不同的 data 鍵,重複性立刻大幅降低。
提醒:$.expr 屬於 jQuery 內部 API,在不同大版本之間曾有變動(例如 Sizzle 引擎整合後改為 $.expr.pseudos)。若要在新專案中使用,建議寫成 jQuery.expr.pseudos.xxx = ... 並確認版本相容性。