CKTIS / HTML
itemref — Mikrodaten-Eigenschaften außerhalb des itemscope-Elements
Das Attribut itemref erweitert die Suche nach Eigenschaften eines Mikrodatenobjekts auf Elemente, die durch ihre id-Werte angegeben werden. So lassen sich Daten außerhalb der Nachfahren des itemscope-Elements zuordnen, ohne die Dokumentstruktur zu ändern.
Version: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
itemref="id1 id2" (on an HTML element with itemscope)itemref ist nur auf einem HTML-Element mit itemscope zulässig. Es gibt zusätzliche Stellen an, an denen nach mit itemprop markierten Eigenschaften gesucht wird; es erzeugt weder eine Eigenschaft noch weist es dem Objekt eine Kennung zu.
Sein Wert ist eine ungeordnete Menge eindeutiger id-Verweise, die durch ASCII-Leerraum getrennt sind. Die Ziele müssen zum selben Baum gehören. Verwende details, nicht #details: Es handelt sich um eine Kennung, nicht um einen CSS-Selektor oder eine URL. Der Algorithmus überspringt ein fehlendes Ziel, doch solches Markup erfüllt nicht die Anforderungen an Autoren.
Die Verarbeitung umfasst das referenzierte Element und seine Nachfahren, steigt aber bei einem weiteren itemscope nicht weiter hinab. Gewöhnliche Nachfahren des ursprünglichen Objekts bleiben eingeschlossen. Vermeide sich überschneidende Pfade, durch die ein Element erneut besucht wird, sowie zyklische Objektbeziehungen: Beides sind Mikrodatenfehler.
Im Beispiel liefert details dem Objekt mit name die Eigenschaft role. Das Objekt hat absichtlich kein itemtype; seine Eigenschaftsnamen sind für die lokale Verwendung bestimmt. Die Ausgabe stellt eine vereinfachte Eigenschaftszuordnung dar und keinen Text, den der Browser automatisch ausgibt.
Beispiele
<!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>Ergebnis
{"name":"Ada","role":"Programmer"}Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.