itemtype

概要

Itemtypeにはデータ構造の中でitemprops(item properties)を定義するのに使われるボキャブラリーのURLを指定します。Itemscope はitemtypeによって指定されるvocabularyが有効になる範囲を指定するのに使われます。

Googleやほかのメジャーな検索エンジンが schema.orgのvocabularyをデータの構造化の為にサポートしています。この vocabularyはタイプ名とプロパティ名のセットとして定義されています。例としてMusicEventはコンサートのイベントがあることを示していて、startDateプロパティやlocationプロパティでコンサートの主要な詳細を指定します。このケースではMusicEventはitemtypeを使用してURLを指定し、startDateやlocationなどのMusicEventで定義されている itempropを指定します。

シンプルな例

HTML

<div itemscope itemtype="https://schema.org/Product">
  <span itemprop="brand">ACME</span>
  <span itemprop="name">Executive Anvil</span>
</div>

構造化されたデータ

Itemtype

• itemtype属性は値を持つことが必須です。値は一連のソートされていない一意なtokenで大文字と小文字を区別します。それぞれのトークンは妥当な絶対URLで、同じvocabularyを使用する必要があります。(同じトークンなら同じvocablaryを使用する必要があります。)この属性の値には少なくとも一つ以上のトークンを指定する必要があります。
• itemtypeは該当仕様(schema.orgなど)で定義されている型で、同じvocabularyを使用するためには同じ定義をしないとといけません。
• itemtype属性はitemscope属性が指定されている要素の中でのみ指定できます。
• itemid属性は、itemscope属性とitemtype属性の両方を指定された要素でのみ指定することができ、そして、語彙の仕様によって定義されるとおりに、itemtype属性がアイテムのグローバル識別子をサポートしない語彙を指定するitemscope属性をもつ要素でのみ指定することができます。
• グローバル識別子の正確な意味は、語彙の仕様によって決定されます。これは、同じグローバル識別子をもつ複数の項目が存在することが許可されるかどうか（同じページか異なるページ上かどうか）、そしてその語彙に対する処理規則が同じIDをもつ複数のアイテムの場合の取り扱いに関するものを定義するのはそのような仕様次第です。

例

HTML

<div itemscope itemtype="https://schema.org/Product">
  <span itemprop="brand">ACME<br></span>
  <span itemprop="name">Executive Anvil<br></span>
  <img itemprop="image" src="https://pixabay.com/static/uploads/photo/2015/09/05/18/15/suitcase-924605_960_720.png" width="50" height="50" alt="Executive Anvil logo" /><br>
  
<span itemprop="description">Sleeker than ACME's Classic Anvil, the
    Executive Anvil is perfect for the business traveler
    looking for something to drop from a height.
  <br>
</span>

  Product #: <span itemprop="mpn">925872<br></span>
  <span itemprop="aggregateRating" itemscope itemtype="https://schema.org/AggregateRating">
    Rating: <span itemprop="ratingValue">4.4</span> stars, based on <span itemprop="reviewCount">89
      </span> reviews<p>
  </span>
  
<span itemprop="offers" itemscope itemtype="https://schema.org/Offer">
    Regular price: $179.99<br>
    <meta itemprop="priceCurrency" content="USD" />
    <span itemprop="price">Sale price: $119.99<br></span>
    (Sale ends <time itemprop="priceValidUntil" datetime="2020-11-05">
      5 November!</time>)<br>
    Available from: <span itemprop="seller" itemscope itemtype="https://schema.org/Organization">
                      <span itemprop="name">Executive Objects<br></span>
                    </span>
    Condition: <link itemprop="itemCondition" href="https://schema.org/UsedCondition"/>Previously owned,
      in excellent condition<br>
    <link itemprop="availability" href="https://schema.org/InStock"/>In stock! Order now!
</span>

  </span>

</div>

結果

HTML

構造化されたデータ