Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / HTML

itemref — właściwości mikrodanych poza elementem itemscope

Atrybut itemref rozszerza wyszukiwanie właściwości obiektu mikrodanych o elementy wskazane przez ich id. Pozwala powiązać dane spoza potomków elementu itemscope bez zmiany struktury dokumentu.

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

Składnia

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

itemref można umieścić wyłącznie na elemencie HTML z itemscope. Wskazuje dodatkowe miejsca wyszukiwania właściwości oznaczonych przez itemprop; nie tworzy właściwości ani nie nadaje obiektowi identyfikatora.

Wartość to nieuporządkowany zbiór unikalnych identyfikatorów id, rozdzielonych białymi znakami ASCII. Cele muszą należeć do tego samego drzewa. Podawaj details, nie #details: to identyfikator, a nie selektor CSS ani URL. Algorytm pomija brakujący cel, ale taki zapis nie spełnia wymagań dla autorów.

Przetwarzanie obejmuje wskazany element i jego potomków, lecz zatrzymuje zagłębianie przy kolejnym itemscope. Zwykli potomkowie pierwotnego obiektu nadal są uwzględniani. Unikaj nakładających się ścieżek powodujących ponowne odwiedzenie elementu oraz cyklicznych powiązań obiektów: są to błędy mikrodanych.

W przykładzie details dostarcza role obiektowi zawierającemu name. Obiekt celowo nie ma itemtype; nazwy właściwości służą lokalnemu użyciu. Wynik przedstawia uproszczoną mapę właściwości, nie tekst automatycznie wypisywany przez przeglądarkę.

Przykłady

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

Wynik

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

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła