CKTIS / HTML
itemref — propriétés de microdonnées en dehors de l’élément itemscope
L’attribut itemref étend la recherche des propriétés d’un élément de microdonnées aux éléments désignés par leurs valeurs id. Il associe des données situées hors des descendants de l’élément itemscope sans modifier la structure du document.
Version : WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
itemref="id1 id2" (on an HTML element with itemscope)itemref n’est autorisé que sur un élément HTML doté de itemscope. Il indique d’autres endroits où rechercher des propriétés marquées avec itemprop ; il ne crée pas de propriété et n’attribue pas d’identifiant à l’élément.
Sa valeur est un ensemble non ordonné de références id uniques, séparées par des espaces blancs ASCII. Les cibles doivent appartenir au même arbre. Écrivez details, et non #details : il s’agit d’un identifiant, pas d’un sélecteur CSS ni d’une URL. L’algorithme ignore une cible absente, mais ce balisage ne respecte pas les exigences destinées aux auteurs.
Le traitement inclut l’élément référencé et ses descendants, mais cesse de descendre lorsqu’il rencontre un autre itemscope. Les descendants ordinaires de l’élément d’origine restent inclus. Évitez les parcours qui se chevauchent et revisitent un élément, ainsi que les relations cycliques entre éléments : ce sont des erreurs de microdonnées.
Dans l’exemple, details fournit la propriété role à l’élément qui contient name. Cet élément n’a volontairement pas de itemtype ; les noms de propriétés sont destinés à un usage local. La sortie représente une carte de propriétés simplifiée, et non du texte automatiquement affiché par le navigateur.
Exemples
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>itemref example</title>
<div itemscope itemref="details">
<span itemprop="name">Ada</span>
</div>
<div id="details">
<span itemprop="role">Programmer</span>
</div>
</html>Résultat
{"name":"Ada","role":"Programmer"}Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.