萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

jQuery data() 方法讀寫 HTML5 data-* 自訂屬性完整指南

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() 差異

取得所有資料

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
特性.data(key).attr('data-key')
儲存位置jQuery 內部快取(記憶體)DOM 屬性
型別自動轉換永遠字串
效能讀寫快(無 DOM 操作)較慢
同步性不自動同步至 DOM即時反映 DOM