730

I would like to know what selectors are available for these data attributes that come with HTML5.

Taking this piece of HTML as an example:

<ul data-group="Companies">
  <li data-company="Microsoft"></li>
  <li data-company="Google"></li>
  <li data-company ="Facebook"></li>
</ul>

Are there selectors to get:

  • All elements with data-company="Microsoft" below "Companies"
  • All elements with data-company!="Microsoft" below "Companies"
  • In other cases is it possible to use other selectors like "contains, less than, greater than, etc...".
2

4 Answers 4

1140
$("ul[data-group='Companies'] li[data-company='Microsoft']") //Get all elements with data-company="Microsoft" below "Companies"

$("ul[data-group='Companies'] li:not([data-company='Microsoft'])") //get all elements with data-company!="Microsoft" below "Companies"

Look in to jQuery Selectors :contains is a selector

here is info on the :contains selector

8
  • will this work? $('div[data-col="1"][data-row="2"]') Will this select the div where data-col equals 1 and data-row equals 2, or will it select on either of those?
    – Luuuud
    Commented Oct 11, 2012 at 13:53
  • 13
    Will this work if data is set via .data('something',value)? Often this does not create an actual attribute when attaching the value. I know the OP was pretty specific regarding attributes, but thought I'd raise awareness in case others have issue with this selector.
    – AaronLS
    Commented Jun 6, 2013 at 0:58
  • 19
    @AaronLS No it doesn't (at least not with older versions of jQuery eg. 1.4.4) - you need to set the data using .attr('data-something', 'value') to see the update in the HTML. As per stackoverflow.com/questions/6827810/…
    – Matty J
    Commented Jul 3, 2013 at 8:05
  • Isn't there a way to get data attribute values without typing data in the call?
    – ahnbizcad
    Commented Jul 2, 2014 at 9:26
  • @gwho $('#element').data('something')
    – Gaui
    Commented Jul 12, 2014 at 18:08
78

jQuery UI has a :data() selector which can also be used. It has been around since Version 1.7.0 it seems.

You can use it like this:

Get all elements with a data-company attribute

var companyElements = $("ul:data(group) li:data(company)");

Get all elements where data-company equals Microsoft

var microsoft = $("ul:data(group) li:data(company)")
                    .filter(function () {
                        return $(this).data("company") == "Microsoft";
                    });

Get all elements where data-company does not equal Microsoft

var notMicrosoft = $("ul:data(group) li:data(company)")
                       .filter(function () {
                           return $(this).data("company") != "Microsoft";
                       });

etc...

One caveat of the new :data() selector is that you must set the data value by code for it to be selected. This means that for the above to work, defining the data in HTML is not enough. You must first do this:

$("li").first().data("company", "Microsoft");

This is fine for single page applications where you are likely to use $(...).data("datakey", "value") in this or similar ways.

8
  • I don't get your caveat. This works fine for me, and I make no other reference to data in the js. $('#id').text($('#mydatasource').data('empty')); This will populate the #id element with the contents of the data-empty tag on the #mydatasource element. Commented Jun 25, 2014 at 9:57
  • 6
    @FacebookAnswers Did you use the :data() selector, or the .data() method?
    – rhughes
    Commented Jun 26, 2014 at 3:40
  • 7
    ^you mean his caveat referred to the selector.
    – ahnbizcad
    Commented Jul 2, 2014 at 8:56
  • 2
    Weird, now it seems to work in the fiddle with Jquery 3.3.1: jsfiddle.net/kai_noack/q6nzLs20/1
    – Avatar
    Commented Sep 29, 2019 at 15:06
  • 2
    @Avatar The :data() selector is from jQueryUI, it's not in jQuery. That's why you get that syntax error. In the fiddle you are using the data attribute selector ul[data-group] which is a CSS selector and it works with jQuery (and the one used in the accepted answer).
    – Romualdo
    Commented May 25, 2021 at 20:10
49

jsFiddle Demo

jQuery provides several selectors (full list) in order to make the queries you are looking for work. To address your question "In other cases is it possible to use other selectors like "contains, less than, greater than, etc..."." you can also use contains, starts with, and ends with to look at these html5 data attributes. See the full list above in order to see all of your options.

The basic querying has been covered above, and using John Hartsock's answer is going to be the best bet to either get every data-company element, or to get every one except Microsoft (or any other version of :not).

In order to expand this to the other points you are looking for, we can use several meta selectors. First, if you are going to do multiple queries, it is nice to cache the parent selection.

var group = $('ul[data-group="Companies"]');

Next, we can look for companies in this set who start with G

var google = $('[data-company^="G"]',group);//google

Or perhaps companies which contain the word soft

var microsoft = $('[data-company*="soft"]',group);//microsoft

It is also possible to get elements whose data attribute's ending matches

var facebook = $('[data-company$="book"]',group);//facebook

//stored selector
var group = $('ul[data-group="Companies"]');

//data-company starts with G
var google = $('[data-company^="G"]',group).css('color','green');

//data-company contains soft
var microsoft = $('[data-company*="soft"]',group).css('color','blue');

//data-company ends with book
var facebook = $('[data-company$="book"]',group).css('color','pink');
<script src="https://ajax.googleapis.com/ajax/libs/jquery/2.1.1/jquery.min.js"></script>
<ul data-group="Companies">
  <li data-company="Microsoft">Microsoft</li>
  <li data-company="Google">Google</li>
  <li data-company ="Facebook">Facebook</li>
</ul>

7

Pure/vanilla JS solution (working example here)

// All elements with data-company="Microsoft" below "Companies"
let a = document.querySelectorAll("[data-group='Companies'] [data-company='Microsoft']"); 

// All elements with data-company!="Microsoft" below "Companies"
let b = document.querySelectorAll("[data-group='Companies'] :not([data-company='Microsoft'])"); 

In querySelectorAll you must use valid CSS selector (currently Level3)

SPEED TEST (2018.06.29) for jQuery and Pure JS: test was performed on MacOs High Sierra 10.13.3 on Chrome 67.0.3396.99 (64-bit), Safari 11.0.3 (13604.5.6), Firefox 59.0.2 (64-bit). Below screenshot shows results for fastest browser (Safari):

enter image description here

PureJS was faster than jQuery about 12% on Chrome, 21% on Firefox and 25% on Safari. Interestingly speed for Chrome was 18.9M operation per second, Firefox 26M, Safari 160.9M (!).

So winner is PureJS and fastest browser is Safari (more than 8x faster than Chrome!)

Here you can perform test on your machine: https://jsperf.com/js-selectors-x

Not the answer you're looking for? Browse other questions tagged or ask your own question.