MDN’s new design is in Beta! A sneak peek: https://blog.mozilla.org/opendesign/mdns-new-design-beta/

itemtype

概要

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

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

Note: そのほかのitemtype属性についてはhttp://schema.org/Thingをご覧ください

シンプルな例

HTML

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

構造化されたデータ

itemscope itemtype schema.org Product
itemprop name Executive Anvil
itemprop brand [Thing]
itemprop name ACME

Itemtype

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

HTML

<div itemscope itemtype="http://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="http://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="http://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="http://schema.org/Organization">
                      <span itemprop="name">Executive Objects<br></span>
                    </span>
    Condition: <link itemprop="itemCondition" href="http://schema.org/UsedCondition"/>Previously owned,
      in excellent condition<br>
    <link itemprop="availability" href="http://schema.org/InStock"/>In stock! Order now!
</span>

  </span>

</div>

結果

HTML

構造化されたデータ

itemscope itemtype Product (http://schema.org/Product)
itemprop name Executive Anvil
itemprop image https://pixabay.com/static/uploads/photo/2015/09/05/18/15/suitcase-924605_960_720.png
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.
itemprop mpn 925872
itemprop brand [Thing]  
itemprop name ACME
itemscope itemprop[itemtype] aggregateRating[AggregateRating]  
itemprop ratingValue 4.4
itemprop reviewCount 89
itemprop offers [Offer] http://schema.org/Offer
itemprop priceCurrency USD
itemprop price 119.99
itemprop priceValidUntil 2020-11-05
itemprop itemCondition http://schema.org/UsedCondition
itemprop availability
http://schema.org/InStock
itemscope itemprop[itemtype] seller [Organization] http://schema.org/Organization
itemprop name Executive Objects

Note: HTMLからmicrodataを抜き出す便利なツールがGoogleから提供されています。 Structured Data Testing Tool. 上のHTMLを試してみるといいでしょう。

仕様書

仕様 状態
itemtype WG Note - もはや積極的に開発されていません 【訳注: [1]】

【訳注: [1] 英語版の仕様に関する情報がW3C NoteとWHATWG HTML Standardと混ざったものになっているため、不正確な情報です。】

ドキュメントのタグと貢献者

 このページの貢献者: lv7777, momdo
 最終更新者: lv7777,