在前端專案裡,把一堆零散的設定值收攏到一個配置物件中,是很常見的需求。jQuery 提供的 $.extend() 正是為此而生。本文透過語法說明與一個可運行的範例,帶你把這個方法徹底弄懂。
jQuery.extend([deep], target, object1, [objectN])
它的職責是「用一個或多個來源物件去擴充一個目標物件」,最後回傳被擴充後的那個目標物件。幾個關鍵行為值得記住:
target,jQuery 會把能力掛到 jQuery 命名空間本身,這正是插件作者用來新增全域靜態方法的途徑。true,則進行深拷貝,遇到巢狀物件會遞迴複製;否則只是淺拷貝,副本與原物件共享內部結構。undefined 的屬性不會被複製,但透過原型鏈繼承來的可列舉屬性會被複製過去。下面的例子把頁面上需要用到的幾個 URL 與識別名稱集中到 pageConfig 中,點擊按鈕時讀取其中的刪除路徑。
<!DOCTYPE html>
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>extendFun</title>
<script src="../scripts/jquery-1.9.0.js" type="text/javascript"></script>
<script type="text/javascript">
$(function () {
var pageConfig = {};
pageConfig = $.extend(pageConfig, {
createUrl: '${ROOT}/subject/createOrModifyPageTemplates',
deleteUrl: '${ROOT}/subject/deletePageTemplates',
modifyUrl: '${ROOT}/subject/createOrModifyPageTemplates',
infoName: 'pageTemplateInfo'
});
$("#subm").click(function () {
var posturl = pageConfig.deleteUrl;
alert(posturl);
});
});
</script>
</head>
<body>
<input id="subm" name="subm" type="button" value="clickme" />
</body>
</html>
點擊按鈕後彈出的內容為:
${ROOT}/subject/deletePageTemplates
由於 $.extend() 會直接改寫第一個參數,實務上常見兩種寫法:一是像上例那樣以空物件起手,把設定「歸檔」到既有物件;二是用 $.extend({}, defaults, options),先複製一份預設值再合併使用者傳入的選項,如此一來 defaults 不會被汙染。理解淺拷貝與深拷貝的差異,是避免「改了 B 卻連 A 一起變」這類 bug 的關鍵。