Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / HTML

itemref — propriedades de microdados fora do elemento itemscope

O atributo itemref alarga a pesquisa de propriedades de um elemento de microdados a elementos identificados pelos respetivos valores id. Associa dados que estão fora dos descendentes do elemento itemscope sem alterar a estrutura do documento.

Versão: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaxe

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

itemref só é permitido num elemento HTML com itemscope. Indica outros locais onde procurar propriedades marcadas com itemprop; não cria uma propriedade nem atribui um identificador ao elemento.

O seu valor é um conjunto não ordenado de referências id únicas, separadas por espaços em branco ASCII. Os destinos têm de pertencer à mesma árvore. Escreva details, não #details: trata-se de um identificador, não de um seletor CSS nem de um URL. O algoritmo ignora um destino em falta, mas essa marcação não cumpre os requisitos para autores.

O processamento inclui o elemento referenciado e os seus descendentes, mas deixa de percorrer a árvore ao encontrar outro itemscope. Os descendentes comuns do elemento original continuam incluídos. Evite percursos sobrepostos que voltem a visitar um elemento e relações cíclicas entre elementos: são erros de microdados.

No exemplo, details fornece role ao elemento que contém name. O elemento não tem itemtype de propósito; os nomes das propriedades destinam-se a uso local. O resultado representa um mapa de propriedades simplificado, não texto apresentado automaticamente pelo navegador.

Exemplos

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

Resultado

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

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes