jQuery获取html5的data-*属性缓存的坑，jquery 操作HTML data全局属性缓存的坑

 

javascripthtml html5 jquery

 阅读约 5 分钟

今天做项目的时候发现一个坑，关于jQuery获取data-*属性的方法data()，特写此篇来记录。

data-*自定义数据属性

HTML5规定可以为元素添加非标准型的属性，只需添加前缀data-，这些属性可以随意添加，随意命名，目的是为元素提供与渲染无关的信息，或提供语义信息。

js获取data-*的方式

• 通过dataset属性访问

  //HTML代码
  <div id="myDiv" data-appid="123" data-myname="lsxj"></div>

  //js代码
  var div = document.getElementById("myDiv");
  var appId = div.dataset.appid;//获取data-appid的值
  var myName = div.dataset.myname;//获取data-myname的值
  //设置值
  div.dataset.appid = 456;
  div.dataset.myname = "newname";

  //最终HTML结果
  <div id="myDiv" data-appid="456" data-myname="newname"></div>

dataset属性的值是DOMStringMap的一个实例，名值对的映射。每个data-name形式的属性都有一个对应的属性，只不过该属性名没有data-前缀。

兼容性：

需要注意的是，dataset中大小写的问题。带连字符连接的名称在使用的时候需要命名驼峰化。例如data-my-name对应的是dataset.myName的值。可看以下代码

//将上面代码的设置值部分进行修改
 div.dataset.appId = 789;
 div.dataset.myName = "secondname";
 
 //最终结果
 <div id="myDiv" data-appid="123" data-myname="lsxj" data-app-id="456" data-my-name="secondname"></div>

• 传统获取方式 `getAttribute

  还是上述的例子。获取data-*的方法可使用如下方法：

  var appId = div.getAttribute("data-appid");

jQuery获取方法

• data()方法

  //HTML代码
  <div id="myDiv" data-appid="123" data-myname="lsxj" data-app-id="456" data-my-name="secondname"></div>

  //获取属性
  var appid = You can't use 'macro parameter character #' in math mode("#myDiv").data("app-id"); //456

  //属性赋值
  $("#myDiv").data("appid","666");

  //最终HTML代码
  <div id="myDiv" data-appid="123" data-myname="lsxj" data-app-id="456" data-my-name="secondname"></div>

需要注意的是，data()的值进行修改并不会影响到DOM元素上的data-*属性的改变。data()的本质其实是将一个 “cache” 附加到了对象上，并使用了一个特殊的属性名称。

所以上述代码中，虽然对div进行了data()赋值操作，但HTML代码中div的data-appid的值仍然为123，因为data()只是修改了缓存的那个值，此时进行$('#myDiv').data("appid")的操作，输出的结果为666.

• attr()方法

  var appid = $("#myDiv").attr("data-appid");

 

 

### 总结2

data-* 全局属性 是一类被称为自定义数据属性的属性，它赋予我们在所有 HTML 元素上嵌入自定义数据属性的能力，并可以通过脚本(一般指JavaScript) 与 HTML 之间进行专有数据的交换。

简单的说就是html元素可以通过data-*属性存一些数据，类似于一个map，如果我们想在html的元素上额外的存一些东西是非常方便的。

一：读取是没问题的
比如我们读取div中data-num的数据：
<div id="div1" data-num="1">
dataSet
</div>

分别用jquery和js的方法读取，结果都是1。

 

二：修改就有坑了
但是修改的data-num的时候就有意思了：

jquery设置data-num中的值为2
jquery读取值的值是2
js读取值的值是1，奇怪，查看下html元素

data-num的值还是1。。。

这个坑，坑了我一早上，后来百度下才知道，原来jquery设置的值是在缓存里。。。
果断查看下jquery的源码，真相都在代码里：

 

三：正确的使用方式
如果需要修改dom元素上的data必须用js的方式：
document.getElementById("div1").dataset.num = "3"

 

四：结论
jquery用缓存的方式，无疑是为了提高读写的效率，但是缓存是个双刃剑，方便我们使用的同时往往还是带来困扰。建议对data的操作要统一，都用jquery或者都用js方式，不要混着用，如果要改变dom上元素的值那只能用js的方式。

PS：类似缓存的坑还有java中的Integer类，Integer中的-128到127的值是存在缓存中的

所以两个Integer的值相互比较的时候，如果值在-128和127之间，两个数相同，用 == 号会返回true，在-128和127范围之外会返回false，给人造成额外的困扰，切记在java中Integer的比较一定要用equals()方法。