itemprop

概要

itemprop属性は、アイテムにプロパティを追加するために使用されます。すべてのHTML要素は、itemprop属性を指定することができ、itempropは、名前-値ペアで構成されます。それぞれの名前-値ペアは、プロパティと呼ばれ、1つ以上のプロパティのグループは、アイテムを形成します。プロパティの値は、文字列かURLのいずれかであり、audio、embed、iframe、img、link、object、source、track、videoを含む非常に幅広い要素と関連付けることができます。

簡単な例

HTML

<div itemscope itemtype ="https://schema.org/Movie">
  <h1 itemprop="name">Avatar</h1>
  <span>Director: <span itemprop="director">James Cameron</span> (born August 16, 1954)</span>
  <span itemprop="genre">Science fiction</span>
  <a href="../movies/avatar-theatrical-trailer.html" itemprop="trailer">Trailer</a>
</div>

構造化されたデータ

プロパティ

プロパティは、文字列かURLのいずれかとなる値を持ちます。 文字列の値がURLである場合、img要素とsrc属性のような、要素とその要素の属性、またはリンクする他の要素や埋め込み外部リソースを用いて表現されます。

文字列である値をもつ3つのプロパティ

<div itemscope>
 <p>My name is <span itemprop="name">Neil</span>.</p>
 <p>My band is called <span itemprop="band">Four Parts Water</span>.</p>
 <p>I am <span itemprop="nationality">British</span>.</p>
</div>

<div itemscope>
 <img itemprop="image" src="google-logo.png" alt="Google">
</div>

文字列が人によって簡単に読むことや理解することができない場合（例えば、長い数字や文字）、要素のコンテンツで与えられるより人に理解しやすいもの (これは構造化されたデータの一部ではありません―下記の例を参照）とともに、data要素のvalue属性を用いて表示することができます。

<h1 itemscope>
 <data itemprop="product-id" value="9678AOU879">The Instigator 2000</data>
</h1>

数値データの場合、meter要素とvalue属性を使用することができます。

<div itemscope itemtype="https://schema.org/Product">
 <span itemprop="name">Panasonic White 60L Refrigerator</span>
 <img src="panasonic-fridge-60l-white.jpg" alt="">
  <div itemprop="aggregateRating"
       itemscope itemtype="https://schema.org/AggregateRating">
   <meter itemprop="ratingValue" min=0 value=3.5 max=5>Rated 3.5/5</meter>
   (based on <span itemprop="reviewCount">11</span> customer reviews)
  </div>
</div>

同様に、日付や時間に関連するデータについて、time要素とdatetime属性を使用することができます。

<div itemscope>
 I was born on <time itemprop="birthday" datetime="2009-05-10">May 10th 2009</time>.
</div>

プロパティはまた、 プロパティを宣言する要素でitemscope属性を置くことによって、名前-値ペアのグループを持つことができます。それぞれの値は、文字列か名前-値ペア（すなわちアイテム）のいずれかです。

<div itemscope>
 <p>Name: <span itemprop="name">Amanda</span></p>
 <p>Band: <span itemprop="band" itemscope> <span itemprop="name">Jazz Band</span> (<span itemprop="size">12</span> players)</span></p>
</div>

<div itemscope id="amanda" itemref="a b"></div>
<p id="a">Name: <span itemprop="name">Amanda</span></p>
<div id="b" itemprop="band" itemscope itemref="c"></div>
<div id="c">
 <p>Band: <span itemprop="name">Jazz Band</span></p>
 <p>Size: <span itemprop="size">12</span> players</p>
</div>

アイテムは同じ名前かつ異なる値をもつ複数のプロパティを持つことができます。

<div itemscope>
 <p>Flavors in my favorite ice cream:</p>
 <ul>
  <li itemprop="flavor">Lemon sorbet</li>
  <li itemprop="flavor">Apricot sorbet</li>
 </ul>
</div>

プロパティを導入する要素はまた、複数のプロパティが同じ値を持つ場合に重複を避けるために、一度に複数のプロパティを導入することができます。

<div itemscope>
 <span itemprop="favorite-color favorite-fruit">orange</span>
</div>

<figure>
 <img src="castle.jpeg">
 <figcaption><span itemscope><span itemprop="name">The Castle</span></span> (1986)</figcaption>
</figure>

<span itemscope><meta itemprop="name" content="The Castle"></span>
<figure>
 <img src="castle.jpeg">
 <figcaption>The Castle (1986)</figcaption>
</figure>

名前と値

プロパティは、大文字・小文字を区別して名前-値ペアを表す一意なトークンの順序なしセットです。下記の例で、それぞれのデータセルはトークンです。

名前の例

トークンは、文字列かURLのいずれかです。アイテムは、URLの場合に型付きアイテムと呼ばれます。そうでなければ、文字列です。文字列は、ピリオドまたはコロンを含むことができません（下記参照）。

1. アイテムが型付きアイテムの場合、次のいずれかでなければなりません：
   1. 定義されたプロパティ名。
   2. または、妥当なURL。これは、語彙定義を参照します。
   3. または、A valid URL that is used as a 所有者のアイテムプロパティ名（すなわち、パブリックな仕様で定義されないもの）として使用される妥当なURL。
2. アイテムが型付きアイテムでない場合は次のようにならなければなりません：
   1. "."（U+002E FULL STOP）文字と":"（U+003A COLON）文字を含まず、 所有者のアイテムプロパティ名（パブリックな仕様で定義されないもの）として使用される文字列。

注： 上記の規則は非URLの値で":"を許可しません。なぜならそうでなければURLと区別できないからです。"."文字をもつ値は、将来の拡張のために予約されます。空白文字は複数のトークンとして解析されるために許可されません。

値

名前-値ペアのプロパティ値は、次のリストで最初にマッチするものに与えられます：

• 要素がitemscope属性を持つ場合
  • 値は要素によって作成されたアイテムを持つ
• 要素がmeta要素である場合
  • 値は、要素のコンテンツ属性の値である
• 要素がaudio、embed、iframe、img、source、track、video要素である場合
  • 値は、属性が設定される時に要素のノード文書（Microdata DOM APIの一部）に関連する要素のsrc属性の解析する値に由来する結果のURL文字列である
• 要素がa、area、link要素である場合
  • 値は、属性が設定される時に要素のノード文書に関連する要素のhref属性の解析する値に由来する結果のURL文字列である
• 要素がobject要素である場合
  • 値は、属性が設定される時に要素のノード文書に関連する要素のdata属性の解析する値に由来する結果のURL文字列である
• 要素がdata要素である場合
  • 値は、要素のvalue属性の値である
• 要素がmeter要素である場合
  • 値は、要素のvalue属性の値である
• 要素がtime要素である場合
  • 値は、要素のdatetime値である

その他

• 値は、要素のtextContentである。

プロパティの値がURLである場合、プロパティはURLプロパティ要素を使用して指定されなければなりません。URLプロパティ要素は、a、area、audio、embed、iframe、img、link、object、source、track、video要素です。

名前の順序

名前は互いに順不同の関係がありますが、特定の名前が複数の値を持つ場合、その値は相対的な順序を持ちます。

<div itemscope>
 <p itemprop="a">1</p>
 <p itemprop="a">2</p>
 <p itemprop="b">test</p>
</div>

<div itemscope>
 <p itemprop="b">test</p>
 <p itemprop="a">1</p>
 <p itemprop="a">2</p>
</div>

<div itemscope>
 <p itemprop="a">1</p>
 <p itemprop="b">test</p>
 <p itemprop="a">2</p>
</div>

<div id="x">
 <p itemprop="a">1</p>
</div>
<div itemscope itemref="x">
 <p itemprop="b">test</p>
 <p itemprop="a">2</p>
</div>

例

HTML

<dl itemscope 
    itemtype="https://vocab.example.net/book" 
    itemid="urn:isbn:0-330-34032-8"
 <dt>Title <dd itemprop="title">The Reality Dysfunction 
 <dt>Author <dd itemprop="author">Peter F. Hamilton 
 <dt>Publication date 
 <dd><time itemprop="pubdate" datetime="1996-01-26">26 January 1996</time> </dl>