直接在 DOM 元素上掛載屬性(elem.myData = {...})會導致:
jQuery 通過「鍵-值映射 + 唯一標識」將數據移出 DOM,僅在元素上存一個隨機 expando 屬性作為鑰匙。
// 簡化模型
const cache = {
// uuid -> { expando: { key: value, ... } }
1: { 'jQuery1234567890': { name: 'widget', config: { ... } } },
2: { 'jQuery1234567890': { events: { click: [...] }, data: { ... } } }
};
// DOM 元素:elem[expando] = 1
const expando = "jQuery" + (new Date().getTime() + Math.random()).toString(36).slice(2);
// 例:jQuery1708123456abcdef
極低衝突概率,避免與開發者自定義屬性衝突。
$.data(elem, key, value)function data(elem, key, value) {
// 字符串鍵直接操作頂層 cache(用於內部數據如事件)
if (typeof elem === 'string') {
if (value !== undefined) cache[elem] = value;
return cache[elem];
}
// DOM 元素
if (!elem[expando]) {
elem[expando] = ++uuid; // 分配唯一 ID
}
const id = elem[expando];
if (!cache[id]) cache[id] = {};
if (!cache[id][expando]) cache[id][expando] = {}; // 命名空間隔離
const store = cache[id][expando];
if (value !== undefined) store[key] = value;
return store[key];
}
$.removeData(elem, key?)function removeData(elem, key) {
if (typeof elem === 'string') { delete cache[elem]; return; }
const id = elem[expando];
if (!id || !cache[id]) return;
if (key) {
delete cache[id][expando][key];
// 若命名空間為空,清理整個 id
if ($.isEmptyObject(cache[id][expando])) {
delete cache[id];
delete elem[expando]; // 或 elem.removeAttribute(expando)
}
} else {
delete cache[id];
delete elem[expando];
}
}
$.cleanData(elems):批量清理元素數據、事件、綁定,在 .remove()、.empty()、.html('') 內部調用。elem.removeAttribute(expando) 而非 delete,避免 COM 物件錯誤。(function(window) {
const cache = {}, expando = "jData" + Date.now().toString(36);
let uuid = 0;
function isEmpty(obj) { for (const k in obj) return false; return true; }
window.jData = function(elem, key, value) {
if (typeof elem === 'string') {
if (value !== undefined) cache[elem] = value;
return cache[elem];
}
if (!elem[expando]) elem[expando] = ++uuid;
const id = elem[expando];
if (!cache[id]) cache[id] = {};
if (!cache[id][expando]) cache[id][expando] = {};
const store = cache[id][expando];
if (value !== undefined) store[key] = value;
return store[key];
};
window.jRemoveData = function(elem, key) {
if (typeof elem === 'string') { delete cache[elem]; return; }
const id = elem[expando];
if (!id || !cache[id]) return;
if (key) {
delete cache[id][expando][key];
if (isEmpty(cache[id][expando])) {
delete cache[id];
try { delete elem[expando]; } catch(e) { elem.removeAttribute(expando); }
}
} else {
delete cache[id];
try { delete elem[expando]; } catch(e) { elem.removeAttribute(expando); }
}
};
})(window);
// 測試
const div = document.createElement('div');
jData(div, 'user', { name: 'Tom' });
console.log(jData(div, 'user')); // {name:'Tom'}
jRemoveData(div, 'user');
console.log(jData(div, 'user')); // undefined
$.data(elem, 'pluginName', instance)。$.data(elem, 'events', { click: [...] })。WeakMap:鍵為對象(DOM),值為數據,垃圾回收友好,無需手動清理。const store = new WeakMap(); store.set(elem, { ... });element.dataset:僅限字符串屬性,自動同步到 data-* 屬性。