?
This document uses PHP Chinese website manual Release
itemprop全局屬性用來性質添加到項目中。每個 HTML 元素都可以itemprop指定一個屬性，并且itemprop由一個名稱 - 值對組成。每個名稱 - 值對稱為一個屬性，一組一個或多個屬性形成一個項目。屬性值是一個字符串或一個 URL，并且可以與一個很寬范圍的元素，包括相關聯(lián)<audio>，<embed>，<iframe>，<img>，<link>，<object>，<source>，<track>，和<video>。
例子
下面的例子顯示了一系列用itemprop屬性標記的元素的源代碼，后面跟著一張顯示結果數(shù)據(jù)的表格。
HTML
<div itemscope itemtype ="http://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>
結構化數(shù)據(jù)
Item | ||
|---|---|---|
itemprop name | itemprop value | |
itemprop | name | Avatar |
itemprop | director | James Cameron |
itemprop | genre | Science fiction |
itemprop | trailer | ../movies/avatar-theatrical-trailer.html |
屬性
屬性的值是字符串或 URL 。當字符串值是一個 URL 時，它使用<a>元素及其href屬性，<img>元素及其src屬性或鏈接到或嵌入外部資源的其他元素來表示。
三個值為字符串的屬性
<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>
一個屬性，“圖片”，其值是一個 URL
<div itemscope> <img itemprop="image" src="google-logo.png" alt="Google"></div>
當一個字符串值不能被人輕易讀取和理解時（例如，一串長長的數(shù)字和字母），它可以使用數(shù)據(jù)元素的 value 屬性來顯示，而更容易理解的是 a 元素內容中給出的人類版本（這不是結構化數(shù)據(jù)的一部分 - 請參見下面的示例）。
具有屬性，其值為產品 ID 的項目
此 ID 不是人性化的，所以產品的名稱使用了人眼可見的文本而不是 ID 。
<h1 itemscope> <data itemprop="product-id" value="9678AOU879">The Instigator 2000</data></h1>
對于數(shù)字數(shù)據(jù)，可以使用 meter 元素及其 value 屬性。
一個 meter 元素
<div itemscope itemtype="http://schema.org/Product"> <span itemprop="name">Panasonic White 60L Refrigerator</span> <img src="panasonic-fridge-60l-white.jpg" alt=""> <div itemprop="aggregateRating" itemscope itemtype="http://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>
同樣，對于與日期和時間相關的數(shù)據(jù)，可以使用時間元素及其日期時間屬性。
具有一個屬性的項目，“生日”，其值是日期
<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>
上面的外部項目有兩個屬性，“name”和“band”?！皀ame”是“Amanda”，“band”本身就是一個項目，有兩個屬性“name”和“size”。樂隊的“name”是“Jazz Band”，“size”是“12”。本例中的外部項目是頂級微數(shù)據(jù)項目。不屬于他人的項目稱為頂級微數(shù)據(jù)項目。
所有屬性都與其項目分開
這個例子與前一個例子相同，但所有的屬性都與它們的項目分開
<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>
這給出了與前面的例子相同的結果。第一個項目有兩個屬性，“name”，設置為“Amanda”，和“band”，設置為另一個項目。第二個項目還有兩個屬性，“name”，設置為“Jazz Band”和“size”，設置為“12”。
一個項目可以具有多個具有相同名稱和不同值的屬性。
冰淇淋有兩種口味
<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>
這產生了具有兩個屬性的項目，其名稱為“flavor”并具有“Lemon sorbet”和“Apricot sorbet”的值。
引入屬性的元素也可以同時引入多個屬性，以避免在某些屬性具有相同值時重復。
具有兩個屬性的項目，“favorite-color”和“favorite-fruit”，都設置為值“orange”
<div itemscope> <span itemprop="favorite-color favorite-fruit">orange</span></div>
注意：微數(shù)據(jù)和微數(shù)據(jù)標記文檔的內容之間沒有關系。
以兩種不同的方式標記相同的結構化數(shù)據(jù)
以下兩個例子之間沒有語義上的區(qū)別
<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>
兩者都有一個帶有標題的圖形，而且與圖形完全無關，都有一個帶名稱 - 值對的項目，名稱為“name”，值為“The Castle”。唯一的區(qū)別是，如果用戶將無形文字拖出文檔，則該項目將包含在拖放數(shù)據(jù)中。與該項目相關的圖像將不包含在內。
Names 和 values
屬性是區(qū)分大小寫的唯一令牌的無序集合，它表示名稱 - 值對。屬性值必須至少有一個令牌。在下面的例子中，每個數(shù)據(jù)單元都是一個令牌。
名稱的例子
Item | ||
|---|---|---|
itemprop name | itemprop value | |
itemprop | country | Ireland |
itemprop | Option | 2 |
itemprop | https://www.flickr.com/photos/nlireland/6992065114/ | Ring of Kerry |
itemprop | img | https://www.flickr.com/photos/nlireland/6992065114/ |
itemprop | website | flickr |
itemprop | (token) | (token) |
Tokens 是字符串或 URL 。如果一個項目是一個 URL，那么它就被稱為一個類型項目。否則，它是一個字符串。字符串不能包含句點或冒號（見下文）。
如果該項目是一個輸入項目，它必須是：
定義的屬性名稱，或
一個有效的 URL，指的是詞匯定義，或者
用作專有項目屬性名稱的有效 URL（即未在公共規(guī)范中定義的URL）或
如果物品不是打印物品，則必須是：
一個不包含“ 。 ”（U + 002E FULL STOP）字符且不包含“ ： ”字符（U + 003A COLON）的字符串，用作專有項目屬性名稱（同樣，未在公開說明中定義）。
注意：上面的規(guī)則不允許在非 URL 值中使用“：”字符，否則它們無法與 URL 區(qū)分。帶“?！钡闹?字符被保留用于未來的擴展?？崭褡址遣辉试S的，否則這些值將被解析為多個標記。
Values
名稱 - 值對的屬性值與以下列表中第一個匹配的情況相同：
如果元素有一個 itemscope 屬性
該值是元素創(chuàng)建的項目。
如果元素是 meta 元素
該值是元素內容屬性的值
如果元素是 audio，embed，iframe，img，source，track 或 video 元素
該值是由設置屬性時元素的 src 屬性相對于元素的節(jié)點文檔（Microdata DOM API 的一部分）解析而得到的結果 URL 字符串
如果元素是 a，area 或 link 元素
該值是生成的 URL 字符串，它是通過在設置屬性時解析元素的 href 屬性相對于元素的節(jié)點文檔的值而得到的
如果元素是一個 object 元素
該值是生成的 URL 字符串，它是通過在設置屬性時解析元素的 data 屬性的值相對于元素的節(jié)點文檔而得出的
如果元素是 data 元素
該值是元素的值屬性的值
如果元素是一個 meter 元素
該值是元素的值屬性的值
如果元素是 time 元素
該值是元素的日期時間值
除此以外
值是元素的 textContent 。
如果屬性的值是一個 URL，則必須使用 URL 屬性元素來指定該屬性。URL屬性元素是 a, area, audio, embed, iframe, img, link, object, source, track, 和 video 元素。
名稱順序
名稱相對于彼此是無序的，但是如果某個特定名稱具有多個值，則它們具有相對順序。
在以下示例中，“a”屬性的值依次為 “1”和“2” ，但“a”屬性是否位于“b”屬性之前并不重要
<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="http://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>
結構化數(shù)據(jù)
itemscope | itemtype: itemid | http://vocab.example.net/book: urn:isbn:0-330-34032-8 |
|---|---|---|
itemprop | title | The Reality Dysfunction |
itemprop | author | Peter F. Hamilton |
itemprop | pubdate | 1996-01-26 |
結果
規(guī)范
Specification | Status | Comment |
|---|---|---|
itemprop | WG Note - No longer being actively developed |
瀏覽器兼容性
Feature | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari |
|---|---|---|---|---|---|
Basic support | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) |
Feature | Android | Chrome for Android | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
|---|---|---|---|---|---|---|
Basic support | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) |