Attributes API

attr.get()

Gets the attribute values of the matched DOM elements.

  • Accepts arguments as strings and arrays of strings.
    You can pass attributes as individual arguments, as an array, or as a string separated by commas or spaces.
    Each value is seen as a new argument.
  • Returns a string if a single argument and a single matched DOM element.
    Returns an object if multiple arguments and a single matched DOM element.
    Returns an array of strings if multiple arguments and a single matched DOM element.
    Returns an array of objects if multiple arguments and multiple matched DOM elements.
    If the attribute value is missing, it will be null.
Example: 
// <div data-name="book" class="cat">0</div>
// <div data-name="book 1">1</div>
// <div>2</div>

$('div').attr.get();
// {'data-name': 'book', class: 'cat'}

$('div ? 1').attr.get();
// {'data-name': 'book 1'}

$('div ? 1').attr.get('class');
// null

$('div').attr.get('data-name');
// 'book'

$('div').attr.get('class');
// 'cat'

$('div').attr.get('data-name', 'class');
$('div').attr.get(['data-name', 'class']);
$('div').attr.get('data-name, class');
$('div').attr.get('data-name class');
// {'data-name': 'book', class: 'cat'}

$('div ?').attr.get();
// [{'data-name': 'book', class: 'cat'}, {'data-name': 'book 1'}, {}]

$('div ?').attr.get('data-name');
// ['book', 'book 1', null]

$('div ?').attr.get('data-name', 'class');
// [{'data-name': 'book', class: 'cat'}, {'data-name': 'book 1', class: null}, {'data-name': null, class: null}]
Previous val() Next attr.set()