Properties that are not descendants of an element with the itemscope
attribute can be associated with an item using the global attribute itemref
.
itemref
provides a list of element IDs (not itemid
s) elsewhere in the document, with additional properties
The itemref
attribute can only be specified on elements that have an itemscope
attribute specified.
Note: the itemref
attribute is not part of the microdata data model. It is merely a syntactic construct to aid authors in adding annotations to pages where the data to be annotated does not follow a convenient tree structure. For example, it allows authors to mark up data in a table so that each column defines a separate item while keeping the properties in the cells.
Example
HTML
<div itemscope id="amanda" itemref="a b"></div>
<p id="a">Name: <span itemprop="name">Amanda</span> </p>
<div id="b" itemprop="band" itemscope itemref="c"></div>
<div id="c">
<p>Band: <span itemprop="name">Jazz Band</span> </p>
<p>Size: <span itemprop="size">12</span> players</p>
</div>
Structured data
(in JSON-LD format)
{
"@id": "amanda",
"name": "Amanda",
"band": {
"@id": "b",
"name": "Jazz Band",
"size": 12
}
}
Result
Specifications
Specification | Status | Comment |
---|---|---|
HTML MicrodataThe definition of 'itemref' in that specification. | Working Draft | |
HTML Living StandardThe definition of 'itemref' in that specification. | Living Standard |
Browser compatibility
The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
Update compatibility data on GitHub
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
itemref
|
Chrome
Full support Yes |
Edge
Full support 12 |
Firefox
Full support Yes |
IE
Full support Yes |
Opera
Full support Yes |
Safari
Full support Yes |
WebView Android
Full support Yes |
Chrome Android
Full support Yes |
Firefox Android
Full support Yes |
Opera Android
Full support Yes |
Safari iOS
Full support Yes |
Samsung Internet Android
Full support Yes |
Legend
- Full support
- Full support
See also
- Other different global attributes
- Other, microdata related, global attributes:
itemid
itemprop
itemref
itemscope
itemtype
itemref by Mozilla Contributors is licensed under CC-BY-SA 2.5.