--- title: itemscope slug: Web/HTML/Global_attributes/itemscope translation_of: Web/HTML/Global_attributes/itemscope original_slug: Web/HTML/Загальні_атрибути/itemscope ---
itemscope
це глобальний атрибут логічного типу, що визначає сферу асоційованих даних. Атрибут itemscope
визначається на елементах, що створюють нові елементи, який призводить до числа з пар назва-значення, що асоціюється з елементом. Пов'язаний з ним атрибут, {{htmlattrxref("itemtype")}}, використовується для визначення валідної URL зі словника (such as schema.org), що описує елемент та контекст його властивостей. У наступних прикладах в кожному елементі словник взятий з schema.org.
Кожен HTML елемент може мати атрибут itemscope
. itemscope
елемент, який не має itemtype
повинен мати itemref
.
Примітка: Знайти більше інформації про атрибут itemtype
можна на http://schema.org/Thing
Нижченаведений приклад демонструє атрибут itemscope
. В прикладі використовується itemtype
як "http://schema.org/Movie", і три пов'язані атрибути 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>
В наступній таблиці показано структуровані дані з попереднього прикладу.
itemscope | Itemtype | Movie | |
itemprop | (itemprop name) | (значення itemprop) | |
itemprop | director | James Cameron | |
itemprop | genre | Science Fiction | |
itemprop | name | Avatar | |
itemprop | https://youtu.be/0AY1XIkX7bY | Trailer |
itemscope
id атрибутиКоли ви використовуєте атрибут itemscope
для елементу, створюється новий елемент. Новостворений елемент містить групу з пар ім'я-значення. For elements with an itemscope
attribute and an itemtype
attribute, you may also specify an {{htmlattrxref("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 itemptype
attribute. The itemtype
s, Recipe
, AggregateRating
, and NutritionInformation
in the following example are part of the schema.org structured data for a recipe, as specified by the first itemptype
, 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</p></span> </span> <p>Published: <time datetime="2009-11-05" itemprop="datePublished"> November 5, 2009</p></time> <span itemprop="description">This is my grandmother's apple pie recipe. I like to add a dash of nutmeg.<br></span> <span itemprop="aggregateRating" itemscope itemtype="http://schema.org/AggregateRating"> <span itemprop="ratingValue">4.0</span> stars based on <span itemprop="reviewCount">35</span> reviews<br></span> Prep time: <time datetime="PT30M" itemprop="prepTime">30 min<br></time> Cook time: <time datetime="PT1H" itemprop="cookTime">1 hour<br></time> Total time: <time datetime="PT1H30M" itemprop="totalTime">1 hour 30 min<br></time> Yield: <span itemprop="recipeYield">1 9" pie (8 servings)<br></span> <span itemprop="nutrition" itemscope itemtype="http://schema.org/NutritionInformation"> Serving size: <span itemprop="servingSize">1 medium slice<br></span> Calories per serving: <span itemprop="calories">250 cal<br></span> Fat per serving: <span itemprop="fatContent">12 g<br></span> </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>
The following is an example rendering of the preceding code example.
{{EmbedLiveSample('Example', '500', '550', '', 'Web/HTML/Global_attributes/itemscope')}}
itemscope | itemtype | Recipe | |
itemprop | name | 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 | name | 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 |
Note: A handy tool for extracting microdata structures from HTML is Google's Structured Data Testing Tool. Try it on the HTML shown above.
Specification | Status | Comment |
---|---|---|
itemscope |
WG Note - No longer being actively developed |
The following table details this feature's compatibility with popular browsers.
{{CompatibilityTable}}
Feature | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|
Basic support | {{CompatVersionUnknown}} | {{CompatVersionUnknown}} | {{CompatVersionUnknown}} | {{CompatVersionUnknown}} | {{CompatVersionUnknown}} |
Feature | Android | Chrome for Android | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|---|
Basic support | {{CompatVersionUnknown}} | {{CompatVersionUnknown}} | {{CompatVersionUnknown}} | {{CompatVersionUnknown}} | {{CompatVersionUnknown}} | {{CompatVersionUnknown}} |