このページはコミュニティーの尽力で英語から翻訳されました。MDN Web Docsコミュニティーについてもっと知り、仲間になるにはこちらから。
HTML itemtype グローバル属性
グローバル属性のitemtype は、データ構造の中でitemprop （アイテムのプロパティ）を定義するのに使われる語彙の URL を指定します。
itemscope はitemtype が有効になるデータ構造の語彙の対象範囲を設定するために使用します。
Google などの主要な検索エンジンは、構造化データのためにschema.org の語彙に対応しています。この語彙は標準の型名とプロパティ名の組み合わせを定義しています。例えば、MusicEvent はコンサートを示し、startDate およびlocation プロパティでコンサートの主要な詳細を示します。この場合、MusicEvent の URL をitemtype に使用し、startDate やlocation はMusicEvent が定義するitemprop となります。
メモ:itemtype 属性についての詳細は、https://schema.org/Thing をご覧ください
- itemtype 属性には値が必要で、値は大文字小文字を区別する一意のトークンを順不同で並べたもので、それぞれが妥当な絶対 URL であり、すべてが同じ語彙を使用して定義する必要があります。属性の値は 1 つ以上のトークンを含む必要があります。
- アイテム型はすべて、（schema.org などの）適用可能な仕様書で定義された型であり、すべて同じ語彙を使用して定義する必要があります。
- itemtype 属性は itemscope 属性が指定されている要素の中でのみ指定できます。
- itemid 属性は、 itemscope 属性と itemtype 属性の両方を指定された要素でのみ指定することができます。これらは itemscope 属性を持つ要素で、語彙の仕様によって定められるとおり、その itemtype がアイテムのグローバル識別子に対応しない語彙を指定している場合にのみ指定する必要があります。
- グローバル識別子の正確な意味は、語彙の仕様によって決定されます。これは、同じグローバル識別子をもつ複数のアイテムが存在することが許可されるかどうか（同じページか異なるページ上かどうか）、そしてその語彙に対する処理規則が同じ ID をもつ複数のアイテムの場合の取り扱いに関するものを定義するのはそのような仕様次第です。
例
製品の構造化データの表現
この例では、以下のようにマイクロデータ属性を使用して、製品の構造化データを表現しています。
| itemscope | itemtype | Product (https://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] | https://schema.org/Offer | |
| itemprop | priceCurrency | USD | |
| itemprop | price | 119.99 | |
| itemprop | priceValidUntil | 2020-11-05 | |
| itemprop | itemCondition | https://schema.org/UsedCondition | |
| itemprop | availability | https://schema.org/InStock | |
| itemscope | itemprop[itemtype] | seller [Organization] | https://schema.org/Organization |
| itemprop | name | Executive Objects | |
メモ:HTML からマイクロデータを抽出するのに手軽なツールとして、 Google の構造化データテストツールがあります。こちらの HTML で試してみてください。
HTML
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 </span> <p> <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> </p></div>結果
仕様書
| Specification |
|---|
| HTML # attr-itemtype |