HTML - itemref

The global attribute itemref Properties that are not descendants of an element with the itemscope attribute can be associated with the item using an itemref. itemref provides a list of element id's (not itemids) with additional properties elsewhere in the document.

Example

 

HTML

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

id's itemscope itemref   (itemprop name) (itemprop value)
id=amanda itemscope itemref=a,b      
id=a     itemprop name Amanda
id=b itemscope itemref=c   band  
id=c     itemprop Band Jazz Band
    itemprop Size 12

Result

Description  

The global attribute itemref Properties that are not descendants of an element with the itemscope attribute can be associated with the item using an itemref. itemref provides a list of element id's (not itemids) with additional properties elsewhere in the document.

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.

Browser Compatibility  

Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari
Basic support (Yes) (Yes) (Yes) (Yes) (Yes)
Feature Android Chrome for Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Basic support (Yes) (Yes) (Yes) (Yes) (Yes) (Yes)

See Also  

Specifications  

Specification Status Comment
itemref   WG Note - No longer being actively developed

License

© 2016 Mozilla Contributors
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-us/docs/web/html/global_attributes/itemref

Attribute Global attribute HTML Microdata Reference