Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / HTML

itemref — propiedades de microdatos fuera del elemento itemscope

El atributo itemref amplía la búsqueda de propiedades de un elemento de microdatos a elementos identificados por sus valores id. Permite asociar datos que están fuera de los descendientes del elemento itemscope sin cambiar la estructura del documento.

Versión: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaxis

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

itemref solo se permite en un elemento HTML con itemscope. Indica otros lugares donde buscar propiedades marcadas con itemprop; no crea una propiedad ni asigna un identificador al elemento.

Su valor es un conjunto desordenado de referencias id únicas, separadas por espacios en blanco ASCII. Los destinos deben pertenecer al mismo árbol. Escribe details, no #details: es un identificador, no un selector CSS ni una URL. El algoritmo omite un destino que no existe, pero ese marcado no cumple los requisitos para autores.

El procesamiento incluye el elemento referenciado y sus descendientes, pero deja de recorrerlos al encontrar otro itemscope. Los descendientes ordinarios del elemento original siguen incluidos. Evita las rutas superpuestas que vuelven a visitar un elemento y las relaciones cíclicas entre elementos: son errores de microdatos.

En el ejemplo, details proporciona role al elemento que contiene name. El elemento no tiene itemtype deliberadamente; los nombres de sus propiedades son para uso local. El resultado representa un mapa de propiedades simplificado, no texto que el navegador muestre automáticamente.

Ejemplos

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

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes