?
This document uses PHP Chinese website manual Release
itemprop
全局屬性用來(lái)性質(zhì)添加到項(xiàng)目中。每個(gè) HTML 元素都可以itemprop
指定一個(gè)屬性,并且itemprop
由一個(gè)名稱 - 值對(duì)組成。每個(gè)名稱 - 值對(duì)稱為一個(gè)屬性,一組一個(gè)或多個(gè)屬性形成一個(gè)項(xiàng)目。屬性值是一個(gè)字符串或一個(gè) URL,并且可以與一個(gè)很寬范圍的元素,包括相關(guān)聯(lián)<audio>
,<embed>
,<iframe>
,<img>
,<link>
,<object>
,<source>
,<track>
,和<video>
。
下面的例子顯示了一系列用itemprop
屬性標(biāo)記的元素的源代碼,后面跟著一張顯示結(jié)果數(shù)據(jù)的表格。
<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>
Item | ||
---|---|---|
itemprop name | itemprop value | |
itemprop | name | Avatar |
itemprop | director | James Cameron |
itemprop | genre | Science fiction |
itemprop | trailer | ../movies/avatar-theatrical-trailer.html |
屬性的值是字符串或 URL 。當(dāng)字符串值是一個(gè) URL 時(shí),它使用<a>
元素及其href
屬性,<img>
元素及其src
屬性或鏈接到或嵌入外部資源的其他元素來(lái)表示。
<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>
當(dāng)一個(gè)字符串值不能被人輕易讀取和理解時(shí)(例如,一串長(zhǎng)長(zhǎng)的數(shù)字和字母),它可以使用數(shù)據(jù)元素的 value 屬性來(lái)顯示,而更容易理解的是 a 元素內(nèi)容中給出的人類版本(這不是結(jié)構(gòu)化數(shù)據(jù)的一部分 - 請(qǐng)參見(jiàn)下面的示例)。
此 ID 不是人性化的,所以產(chǎn)品的名稱使用了人眼可見(jiàn)的文本而不是 ID 。
<h1 itemscope> <data itemprop="product-id" value="9678AOU879">The Instigator 2000</data></h1>
對(duì)于數(shù)字?jǐn)?shù)據(jù),可以使用 meter 元素及其 value 屬性。
<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>
同樣,對(duì)于與日期和時(shí)間相關(guān)的數(shù)據(jù),可以使用時(shí)間元素及其日期時(shí)間屬性。
<div itemscope> I was born on <time itemprop="birthday" datetime="2009-05-10">May 10th 2009</time>.</div>
通過(guò)將 itemscope 屬性放在聲明該屬性的元素上,屬性也可以是名稱 - 值對(duì)的組。每個(gè)值都是一個(gè)字符串或一組名稱 - 值對(duì)(即一個(gè)項(xiàng)目)。
<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>
上面的外部項(xiàng)目有兩個(gè)屬性,“name”和“band”?!皀ame”是“Amanda”,“band”本身就是一個(gè)項(xiàng)目,有兩個(gè)屬性“name”和“size”。樂(lè)隊(duì)的“name”是“Jazz Band”,“size”是“12”。本例中的外部項(xiàng)目是頂級(jí)微數(shù)據(jù)項(xiàng)目。不屬于他人的項(xiàng)目稱為頂級(jí)微數(shù)據(jù)項(xiàng)目。
這個(gè)例子與前一個(gè)例子相同,但所有的屬性都與它們的項(xiàng)目分開(kāi)
<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>
這給出了與前面的例子相同的結(jié)果。第一個(gè)項(xiàng)目有兩個(gè)屬性,“name”,設(shè)置為“Amanda”,和“band”,設(shè)置為另一個(gè)項(xiàng)目。第二個(gè)項(xiàng)目還有兩個(gè)屬性,“name”,設(shè)置為“Jazz Band”和“size”,設(shè)置為“12”。
一個(gè)項(xiàng)目可以具有多個(gè)具有相同名稱和不同值的屬性。
<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>
這產(chǎn)生了具有兩個(gè)屬性的項(xiàng)目,其名稱為“flavor”并具有“Lemon sorbet”和“Apricot sorbet”的值。
引入屬性的元素也可以同時(shí)引入多個(gè)屬性,以避免在某些屬性具有相同值時(shí)重復(fù)。
<div itemscope> <span itemprop="favorite-color favorite-fruit">orange</span></div>
注意:微數(shù)據(jù)和微數(shù)據(jù)標(biāo)記文檔的內(nèi)容之間沒(méi)有關(guān)系。
以下兩個(gè)例子之間沒(méi)有語(yǔ)義上的區(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>
兩者都有一個(gè)帶有標(biāo)題的圖形,而且與圖形完全無(wú)關(guān),都有一個(gè)帶名稱 - 值對(duì)的項(xiàng)目,名稱為“name”,值為“The Castle”。唯一的區(qū)別是,如果用戶將無(wú)形文字拖出文檔,則該項(xiàng)目將包含在拖放數(shù)據(jù)中。與該項(xiàng)目相關(guān)的圖像將不包含在內(nèi)。
屬性是區(qū)分大小寫的唯一令牌的無(wú)序集合,它表示名稱 - 值對(duì)。屬性值必須至少有一個(gè)令牌。在下面的例子中,每個(gè)數(shù)據(jù)單元都是一個(gè)令牌。
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 。如果一個(gè)項(xiàng)目是一個(gè) URL,那么它就被稱為一個(gè)類型項(xiàng)目。否則,它是一個(gè)字符串。字符串不能包含句點(diǎn)或冒號(hào)(見(jiàn)下文)。
如果該項(xiàng)目是一個(gè)輸入項(xiàng)目,它必須是:
定義的屬性名稱,或
一個(gè)有效的 URL,指的是詞匯定義,或者
用作專有項(xiàng)目屬性名稱的有效 URL(即未在公共規(guī)范中定義的URL)或
如果物品不是打印物品,則必須是:
一個(gè)不包含“ 。 ”(U + 002E FULL STOP)字符且不包含“ : ”字符(U + 003A COLON)的字符串,用作專有項(xiàng)目屬性名稱(同樣,未在公開(kāi)說(shuō)明中定義)。
注意:上面的規(guī)則不允許在非 URL 值中使用“:”字符,否則它們無(wú)法與 URL 區(qū)分。帶“?!钡闹?字符被保留用于未來(lái)的擴(kuò)展。空格字符是不允許的,否則這些值將被解析為多個(gè)標(biāo)記。
名稱 - 值對(duì)的屬性值與以下列表中第一個(gè)匹配的情況相同:
如果元素有一個(gè) itemscope 屬性
該值是元素創(chuàng)建的項(xiàng)目。
如果元素是 meta 元素
該值是元素內(nèi)容屬性的值
如果元素是 audio,embed,iframe,img,source,track 或 video 元素
該值是由設(shè)置屬性時(shí)元素的 src 屬性相對(duì)于元素的節(jié)點(diǎn)文檔(Microdata DOM API 的一部分)解析而得到的結(jié)果 URL 字符串
如果元素是 a,area 或 link 元素
該值是生成的 URL 字符串,它是通過(guò)在設(shè)置屬性時(shí)解析元素的 href 屬性相對(duì)于元素的節(jié)點(diǎn)文檔的值而得到的
如果元素是一個(gè) object 元素
該值是生成的 URL 字符串,它是通過(guò)在設(shè)置屬性時(shí)解析元素的 data 屬性的值相對(duì)于元素的節(jié)點(diǎn)文檔而得出的
如果元素是 data 元素
該值是元素的值屬性的值
如果元素是一個(gè) meter 元素
該值是元素的值屬性的值
如果元素是 time 元素
該值是元素的日期時(shí)間值
除此以外
值是元素的 textContent 。
如果屬性的值是一個(gè) URL,則必須使用 URL 屬性元素來(lái)指定該屬性。URL屬性元素是 a, area, audio, embed, iframe, img, link, object, source, track, 和 video 元素。
名稱相對(duì)于彼此是無(wú)序的,但是如果某個(gè)特定名稱具有多個(gè)值,則它們具有相對(duì)順序。
<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>
<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>
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 |
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) |