HTML 範例
<div id="demo" data-role="page" data-last-value="43" data-hidden="true" data-options='{"name":"John"}'></div>
data() 讀取與自動型別轉換
$('#demo').data('role') === 'page'; // 字串
$('#demo').data('lastValue') === 43; // 數字自動轉型
$('#demo').data('hidden') === true; // 布林自動轉型
$('#demo').data('options').name === 'John'; // 物件自動 parseJSON
型別轉換規則
- 字串若為有效 JSON 物件/陣列(以
{ 或 [ 開頭),自動 $.parseJSON 解析。
- 數字字串(含科學記號)轉為
Number,但 "1E02"、"100.000" 保留字串(因轉換會改變表示形式)。
"true"/"false" → Boolean,"null" → null。
寫入資料
$('#demo').data('newKey', {a:1, b:2}); // 寫入物件,不會寫回 DOM 屬性
$('#demo').attr('data-new-key', 'raw string'); // 若需同步寫入 DOM,用 attr
data() 與 attr() 差異
| 特性 | .data(key) | .attr('data-key') |
| 儲存位置 | jQuery 內部快取(記憶體) | DOM 屬性 |
| 型別 | 自動轉換 | 永遠字串 |
| 效能 | 讀寫快(無 DOM 操作) | 較慢 |
| 同步性 | 不自動同步至 DOM | 即時反映 DOM |
取得所有資料
var all = $('#demo').data(); // {role:'page', lastValue:43, hidden:true, options:{...}, newKey:{...}}
// 此物件為快照,後續 .data(obj) 不會影響 all
最佳實務
- **唯讀資料**(初始化設定)用
data-* + .data() 讀取。
- **運行時狀態**純用
.data() 存取,不污染 DOM。
- 需 CSS 選擇器(
[data-state="active"])或 SEO 可見時,同步 .attr('data-state', 'active')。
copyright ©
萬盛學電腦網 all rights reserved