Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / HTML

itemref — proprietà dei microdati esterne all’elemento itemscope

L’attributo itemref estende la ricerca delle proprietà di un elemento di microdati agli elementi indicati dai rispettivi valori id. Associa dati esterni ai discendenti dell’elemento itemscope senza modificare la struttura del documento.

Versione: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintassi

itemref="id1 id2" (on an HTML element with itemscope)

itemref è consentito solo su un elemento HTML con itemscope. Indica altri punti in cui cercare proprietà contrassegnate con itemprop; non crea una proprietà né assegna un identificatore all’elemento.

Il suo valore è un insieme non ordinato di riferimenti id univoci, separati da caratteri di spaziatura ASCII. Gli elementi di destinazione devono appartenere allo stesso albero. Scrivi details, non #details: è un identificatore, non un selettore CSS né un URL. L’algoritmo ignora una destinazione mancante, ma questo markup non soddisfa i requisiti per gli autori.

L’elaborazione include l’elemento referenziato e i suoi discendenti, ma interrompe la discesa quando incontra un altro itemscope. I discendenti ordinari dell’elemento originale restano inclusi. Evita percorsi sovrapposti che visitano di nuovo un elemento e relazioni cicliche tra elementi: sono errori nei microdati.

Nell’esempio, details fornisce role all’elemento che contiene name. L’elemento è intenzionalmente privo di itemtype; i nomi delle proprietà sono destinati all’uso locale. Il risultato rappresenta una mappa semplificata delle proprietà, non testo stampato automaticamente dal browser.

Esempi

<!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>

Risultato

{"name":"Ada","role":"Programmer"}

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti