itemscope

itemscope — это булево глобальное атрибут, которое определяет область действия связанных метаданных. Указание атрибута itemscope для элемента создаёт новый элемент, что приводит к ряду пар имя-значение, связанных с элементом.

Связанный атрибут itemtype используется для указания допустимого URL-адреса словаря (например, schema.org), описывающего элемент и его контекст свойств. В каждом из следующих примеров словарь взят из schema.org.

Каждый HTML-элемент может иметь указанный атрибут itemscope. Элемент itemscope , у которого нет связанного атрибута itemtype, должен иметь связанный атрибут itemref.

Примечание: Дополнительную информацию об атрибутах itemtype можно найти по адресу https://schema.org/Thing

Атрибуты itemscope id

Когда вы указываете атрибут itemscope для элемента, создается новый элемент. Этот элемент состоит из группы пар имя-значение. Для элементов с атрибутом itemscope и атрибутом itemtype, вы также можете указать атрибут id. Вы можете использовать атрибут id для задания глобального идентификатора нового элемента. Глобальный идентификатор позволяет связать элемент с другими элементами, найденными на страницах по всему интернету.

Примеры

Представление структурированных данных для фильма

В следующем примере itemtype задан как "http://schema.org/Movie", а также указаны четыре связанных атрибута itemprop.

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

html

<div itemscope itemtype="https://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 . Каждый атрибут itemscope устанавливает область действия соответствующего атрибута itemtype . Атрибуты itemtype, Recipe, AggregateRating, и NutritionInformation в данном примере являются частью структурированных данных schema.org для рецепта, как указано в первом атрибуте itemtype и http://schema.org/Recipe.

itemscope	itemtype	Recipe
	itemprop	name	Grandma's Holiday Apple Pie
	itemprop	image	https://c1.staticflickr.com/1/30/42759561_8631e2f905_n.jpg
	itemprop	datePublished	2022-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

Примечание: Утилита для извлечения структур микроданных из HTML — инструмент Google Rich Results Testing Tool. Попробуйте его на показанном здесь HTML.

HTML

html

<div itemscope itemtype="https://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="https://schema.org/Person">
      <span itemprop="name">Carol Smith</span>
    </span>
  </p>
  <p>
    Published:
    <time datetime="2022-11-05" itemprop="datePublished">
      November 5, 20022
    </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="https://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 hour</time>
  <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="https://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 # attr-itemscope

См. также

Другие различные глобальные атрибуты
Другие атрибуты, относящиеся к микроданным:

© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/itemscope