CKTIS / HTML
itemref — microdata-eigenschappen buiten het itemscope-element
Het attribuut itemref breidt het zoeken naar eigenschappen van een microdata-item uit naar elementen die met hun id-waarden worden aangewezen. Zo worden gegevens buiten de nakomelingen van het itemscope-element gekoppeld zonder de documentstructuur te wijzigen.
Versie: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
itemref="id1 id2" (on an HTML element with itemscope)itemref is alleen toegestaan op een HTML-element met itemscope. Het geeft extra plaatsen aan waar naar eigenschappen met itemprop wordt gezocht; het maakt geen eigenschap aan en geeft het item geen identificatie.
De waarde is een ongeordende verzameling unieke id-verwijzingen, gescheiden door ASCII-witruimte. Doelen moeten tot dezelfde boom behoren. Schrijf details, niet #details: dit is een identificatie, geen CSS-selector of URL. Het algoritme slaat een ontbrekend doel over, maar zulke markup voldoet niet aan de auteursvereisten.
De verwerking omvat het aangewezen element en zijn nakomelingen, maar stopt met verder afdalen bij een ander itemscope. Gewone nakomelingen van het oorspronkelijke item blijven inbegrepen. Vermijd overlappende paden die een element opnieuw bezoeken en cyclische itemrelaties: dit zijn microdatafouten.
In het voorbeeld levert details de eigenschap role aan het item met name. Het item heeft bewust geen itemtype; de eigenschapsnamen zijn bedoeld voor lokaal gebruik. De uitvoer is een vereenvoudigde eigenschapskaart, geen tekst die de browser automatisch afdrukt.
Voorbeelden
<!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>Resultaat
{"name":"Ada","role":"Programmer"}De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.