itemref
Référence des éléments supplémentaires (par leur id) contenant des propriétés microdata qui font partie de l'item mais ne sont pas des descendants de l'élément itemscope.
Description
L’attribut itemref permet d’associer à un item microdata (défini par itemscope) des propriétés situées en dehors de son sous-arbre DOM. Il prend une liste d’id d’éléments dont les itemprop sont inclus dans l’item comme s’ils étaient des descendants directs.
Syntaxe
<div itemscope itemtype="https://schema.org/Person" itemref="adresse telephone">
<span itemprop="name">Bob Dupont</span>
</div>
<p id="adresse"><span itemprop="address">10 rue de la Paix, Paris</span></p>
<p id="telephone"><span itemprop="telephone">+33 1 00 00 00 00</span></p>Exemples
Fiche produit avec informations séparées dans le DOM :
<article itemscope itemtype="https://schema.org/Product" itemref="prix disponibilite">
<h1 itemprop="name">Casque audio Pro X</h1>
<img itemprop="image" src="casque.jpg" alt="Casque audio Pro X">
</article>
<!-- Ailleurs dans la page -->
<div id="prix">
<span itemprop="price" content="149.99">149,99 €</span>
</div>
<div id="disponibilite">
<link itemprop="availability" href="https://schema.org/InStock"> En stock
</div>Notes
Usage rare : itemref est nécessaire uniquement quand la structure du DOM ne permet pas de rassembler toutes les propriétés d’un item dans un même sous-arbre. C’est un cas avancé de microdata.
Toujours sur itemscope : itemref ne peut être utilisé que sur un élément portant aussi itemscope.
JSON-LD évite ce problème : avec JSON-LD, les données structurées sont complètement découplées du DOM, rendant itemref inutile.