在此页

• 规范
• 浏览器兼容性
• 另请参阅
• 相关话题

itemscope is a boolean global attribute that defines the scope of associated metadata. Specifying the itemscope attribute for an element creates a new item, which results in a number of name-value pairs that are associated with the element. A related attribute, itemtype , is used to specify the valid URL of a vocabulary (such as schema.org ) that describes the item and its properties context. In each of the following examples, the vocabulary is from schema.org .

Every HTML element may have an itemscope attribute specified. An itemscope element that does not have an associated itemtype must have an associated itemref .

注意： Find more about itemtype attributes at http://schema.org/Thing

简单范例

HTML

The following example specifies the itemscope attribute. The example specifies the itemtype as "http://schema.org/Movie", and specifies three related itemprop 属性。

<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="https://youtu.be/0AY1XIkX7bY" itemprop="trailer">Trailer</a>
</div>
		

结构化数据

The following table shows the structured data from the preceding example.

itemscope	Itemtype	Movie
	itemprop	(itemprop name)	(itemprop value)
	itemprop	director	James Cameron
	itemprop	genre	Science Fiction
	itemprop	名称	Avatar
	itemprop	https://youtu.be/0AY1XIkX7bY	Trailer

itemscope id attributes

When you specify the itemscope attribute for an element, a new item is created. The item consists of a group of name-value pairs. For elements with an itemscope attribute and an itemtype attribute, you may also specify an id attribute. You can use the id attribute to set a global identifier for the new item. A global identifier allows the item to relate to other items found on pages across the Web.

范例

There are four itemscope attributes in the following example. Each itemscope attribute sets the scope of its corresponding itemtype 属性。 itemtype s, Recipe , AggregateRating ，和 NutritionInformation in the following example are part of the schema.org structured data for a recipe, as specified by the first itemtype , http://schema.org/Recipe.

<div itemscope itemtype="http://schema.org/Recipe">
  <h2 itemprop="name">Grandma's Holiday Apple Pie</h2>
  <img itemprop="image" src="https://c1.staticflickr.com/1/30/42759561_8631e2f905_n.jpg" width="50" height="50" />
  <p>
    By <span itemprop="author" itemscope itemtype="http://schema.org/Person">
      <span itemprop="name">Carol Smith</span>
    </span>
  </p>
  <p>
    Published: <time datetime="2009-11-05" itemprop="datePublished">November 5, 2009</time>
  </p>
  <span itemprop="description">This is my grandmother's apple pie recipe. I like to add a dash of nutmeg.</span>
  <br>
  <span itemprop="aggregateRating" itemscope itemtype="http://schema.org/AggregateRating">
    <span itemprop="ratingValue">4.0</span> stars based on <span itemprop="reviewCount">35</span> reviews
  </span>
  <br>
  Prep time: <time datetime="PT30M" itemprop="prepTime">30 min</time><br>
  Cook time: <time datetime="PT1H" itemprop="cookTime">1 hou</time>r<br>
  Total time: <time datetime="PT1H30M" itemprop="totalTime">1 hour 30 min</time><br>
  Yield: <span itemprop="recipeYield">1 9" pie (8 servings)</span><br>
  <span itemprop="nutrition" itemscope itemtype="http://schema.org/NutritionInformation">
    Serving size: <span itemprop="servingSize">1 medium slice</span><br>
    Calories per serving: <span itemprop="calories">250 cal</span><br>
    Fat per serving: <span itemprop="fatContent">12 g</span><br>
  </span>
  <p>
    Ingredients:<br>
    <span itemprop="recipeIngredient">Thinly-sliced apples: 6 cups<br></span>
    <span itemprop="recipeIngredient">White sugar: 3/4 cup<br></span>
    ...
  </p>
  Directions: <br>
  <div itemprop="recipeInstructions">
    1. Cut and peel apples<br>
    2. Mix sugar and cinnamon. Use additional sugar for tart apples. <br>
    ...
  </div>
</div>
		

结果

HTML

The following is an example rendering of the preceding code example.

结构化数据

itemscope	itemtype	Recipe
	itemprop	名称	Grandma's Holiday Apple Pie
	itemprop	image	https://c1.staticflickr.com/1/30/42759561_8631e2f905_n.jpg
	itemprop	datePublished	2009-11-05
	itemprop	description	This is my grandmother's apple pie recipe. I like to add a dash of nutmeg.
	itemprop	prepTime	PT30M
	itemprop	cookTime	PT1H
	itemprop	totalTime	PT1H30M
	itemprop	recipeYield	1 9" pie (8 servings)
	itemprop	recipeIngredient	Thinly-sliced apples: 6 cups
	itemprop	recipeIngredient	White sugar: 3/4 cup
	itemprop	recipeInstructions	1. Cut and peel apples 2. Mix sugar and cinnamon. Use additional sugar for tart apples.
	itemprop	author [Person]
	itemprop	名称	Carol Smith
itemscope	itemprop[itemtype]	aggregateRating [AggregateRating]
	itemprop	ratingValue	4.0
	itemprop	reviewCount	35
itemscope	itemprop[itemtype]	nutrition [NutritionInformation]
	itemprop	servingSize	1 medium slice
	itemprop	calories	250 cal
	itemprop	fatContent	12 g

注意 : A handy tool for extracting microdata structures from HTML is Google's Structured Data Testing Tool . Try it on the HTML shown above.

规范

规范	状态	注释
HTML Microdata The definition of 'itemscope' in that specification.	工作草案
HTML 实时标准 The definition of 'itemscope' in that specification.	实时标准

浏览器兼容性

The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request. 更新 GitHub 上的兼容性数据

	桌面						移动
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet
itemscope	Chrome 完整支持 Yes	Edge 完整支持 12	Firefox 完整支持 Yes	IE 完整支持 Yes	Opera 完整支持 Yes	Safari 完整支持 Yes	WebView Android 完整支持 Yes	Chrome Android 完整支持 Yes	Firefox Android 完整支持 Yes	Opera Android 完整支持 Yes	Safari iOS 完整支持 Yes	Samsung Internet Android 完整支持 Yes

图例

完整支持

完整支持

另请参阅

• Other different global attributes
• Other, microdata related, global attributes:
  • itemid
  • itemprop
  • itemref
  • itemtype

元数据

• 最后修改： 2020 年 11 月 9 日

相关话题

1. HTML
2. 教程：
3. HTML 基础
4. HTML 介绍

   1. Introduction to HTML overview
   2. Getting started with HTML
   3. What's in the head? Metadata in HTML
   4. HTML text fundamentals
   5. Creating hyperlinks
   6. Advanced text formatting
   7. Document and website structure
   8. Debugging HTML
   9. Assessment: Marking up a letter
   10. Assessment: Structuring a page of content
5. 多媒体和嵌入

   1. Multimedia and embedding overview
   2. Images in HTML
   3. Video and audio content
   4. From object to iframe — other embedding technologies
   5. Adding vector graphics to the Web
   6. Responsive images
   7. Assessment: Mozilla splash page
6. 参考：
7. HTML 元素

   1. <a>
   2. <abbr>
   3. <acronym>
   4. <address>
   5. <applet>
   6. <area>
   7. <article>
   8. <aside>
   9. <audio>
   10. <b>
   11. <base>
   12. <basefont>
   13. <bdi>
   14. <bdo>
   15. <bgsound>
   16. <big>
   17. <blink>
   18. <blockquote>
   19. <body>
   20. <br>
   21. <button>
   22. <canvas>
   23. <caption>
   24. <center>
   25. <cite>
   26. <code>
   27. <col>
   28. <colgroup>
   29. <command>
   30. <content>
   31. <data>
   32. <datalist>
   33. <dd>
   34. <del>
   35. <details>
   36. <dfn>
   37. <dialog>
   38. <dir>
   39. <div>
   40. <dl>
   41. <dt>
   42. <element>
   43. <em>
   44. <embed>
   45. <fieldset>
   46. <figcaption>
   47. <figure>
   48. <font>
   49. <footer>
   50. <form>
   51. <frame>
   52. <frameset>
   53. <h1>
   54. <head>
   55. <header>
   56. <hgroup>
   57. <hr>
   58. <html>
   59. <i>
   60. <iframe>
   61. <image>
   62. <img>
   63. <input>
   64. <ins>
   65. <isindex>
   66. <kbd>
   67. <keygen>
   68. <label>
   69. <legend>
   70. <li>
   71. <link>
   72. <listing>
   73. <main>
   74. <map>
   75. <mark>
   76. <marquee>
   77. <menu>
   78. <menuitem>
   79. <meta>
   80. <meter>
   81. <multicol>
   82. <nav>
   83. <nextid>
   84. <nobr>
   85. <noembed>
   86. <noframes>
   87. <noscript>
   88. <object>
   89. <ol>
   90. <optgroup>
   91. <option>
   92. <output>
   93. <p>
   94. <param>
   95. <picture>
   96. <plaintext>
   97. <pre>
   98. <progress>
   99. <q>
   100. <rb>
   101. <rp>
   102. <rt>
   103. <rtc>
   104. <ruby>
   105. <s>
   106. <samp>
   107. <script>
   108. <section>
   109. <select>
   110. <shadow>
   111. <slot>
   112. <small>
   113. <source>
   114. <spacer>
   115. <span>
   116. <strike>
   117. <strong>
   118. <style>
   119. <sub>
   120. <summary>
   121. <sup>
   122. <table>
   123. <tbody>
   124. <td>
   125. <template>
   126. <textarea>
   127. <tfoot>
   128. <th>
   129. <thead>
   130. <time>
   131. <title>
   132. <tr>
   133. <track>
   134. <tt>
   135. <u>
   136. <ul>
   137. <var>
   138. <video>
   139. <wbr>
   140. <xmp>
8. 全局属性

   1. accesskey
   2. autocapitalize
   3. class
   4. contenteditable
   5. contextmenu
   6. data-*
   7. dir
   8. draggable
   9. dropzone
   10. hidden
   11. id
   12. inputmode
   13. is
   14. itemid
   15. itemprop
   16. itemref
   17. itemscope
   18. itemtype
   19. lang
   20. part
   21. slot
   22. spellcheck
   23. style
   24. tabindex
   25. title
   26. translate
   27. x-ms-acceleratorkey
   28. x-ms-format-detection
9. <input> 类型

   1. <input type="button">
   2. <input type="checkbox">
   3. <input type="color">
   4. <input type="date">
   5. <input type="datetime">
   6. <input type="datetime-local">
   7. <input type="email">
   8. <input type="file">
   9. <input type="hidden">
   10. <input type="image">
   11. <input type="month">
   12. <input type="number">
   13. <input type="password">
   14. <input type="radio">
   15. <input type="range">
   16. <input type="reset">
   17. <input type="search">
   18. <input type="submit">
   19. <input type="tel">
   20. <input type="text">
   21. <input type="time">
   22. <input type="url">
   23. <input type="week">
10. 文档编制：
11. 有用清单

    All pages index

    Pages tagged "HTML"
12. 贡献

    1. HTML 文档状态
    2. MDN 工程