Attribut HTML universel : itemref
L'attribut universel itemref permet d'associer des propriétés qui ne sont pas des descendants d'un élément avec l'attribut itemscope.
itemref fournit une liste d'identifiants d'éléments (à ne pas confondre avec itemid) ailleurs dans le document, avec des propriétés supplémentaires.
L'attribut itemref ne peut être défini que sur des éléments qui ont un attribut itemscope défini.
Note :
L'attribut itemref ne fait pas partie du modèle de données des microdonnées. Il s'agit purement d'une construction syntaxique pour aider les auteur·ice·s à annoter une page où les données ne suivent pas une structure arborescente claire. Par exemple, il permet aux auteur·ice·s de baliser des données dans un tableau de manière à ce que chaque colonne définisse un élément distinct tout en conservant les propriétés dans les cellules.
Exemples
Représenter des données structurées pour un groupe
Cet exemple utilise des attributs de microdonnées pour représenter les données structurées suivantes (au format JSON-LD (angl.)) :
{
"@id": "amanda",
"name": "Amanda",
"band": {
"@id": "b",
"name": "Jazz Band",
"size": 12
}
}
HTML
<div itemscope id="amanda" itemref="a b"></div>
<p id="a">Nom : <span itemprop="name">Amanda</span></p>
<div id="b" itemprop="band" itemscope itemref="c"></div>
<div id="c">
<p>Groupe : <span itemprop="name">Jazz Band</span></p>
<p>Taille : <span itemprop="size">12</span> membres</p>
</div>
Résultat
Spécifications
| Specification |
|---|
| HTML # attr-itemref |
Voir aussi
- Tous les attributs universels
- Les autres attributs universels relatifs aux microdonnées :