itemListElement

Свойство schema.org ?

Канонический URL: https://schema.org/itemListElement
👉 Проверить на наличие открытых проблем.

Содержание: Описание, Какие должны быть типы, В каких типах используется, Примеры использования.

Описание:

Для значений itemListElement вы можете использовать простые строки (например, "Петр", "Паул", "Мария"), существующие сущности или использовать ListItem.

Текстовые значения лучше всего подходят, если элементы в списке являются простыми строками. Существующие сущности лучше всего подходят для простого, неупорядоченного списка существующих вещей в ваших данных. ListItem используется с упорядоченными списками, когда вы хотите предоставить дополнительный контекст о элементе в этом списке или когда один и тот же элемент может находиться в разных местах в разных списках.

Примечание: Порядок элементов в вашей разметке недостаточен для указания порядка элементов. В таких случаях используйте ListItem с свойством 'position'.

Свойство itemListElement в Schema.org используется для описания элементов в списке. Оно позволяет структурировать информацию о том, какие элементы входят в определенный список, и как они организованы. Это свойство особенно полезно, когда нужно предоставить более детализированную информацию о каждом элементе, а также указать их порядок.

itemListElement может принимать разные формы: простые текстовые строки, существующие сущности или более сложные объекты типа ListItem. Применение текстовых строк подходит для простых списков, где элементы не требуют дополнительной информации. Существующие сущности лучше использовать, когда нужно ссылаться на уже известные объекты, которые могут быть представлены в неупорядоченном виде.

Когда необходимо указать порядок элементов в списке или предоставить дополнительный контекст, используется ListItem. Это особенно важно, если один и тот же элемент может встречаться в разных местах списка или в разных списках. В таких случаях важно не только упомянуть элемент, но и обозначить его позицию с помощью свойства position.

Таким образом, itemListElement помогает организовать и структурировать данные, делая их более понятными и доступными для машинной обработки, что в свою очередь улучшает видимость информации в поисковых системах и других платформах.

Ожидается, что значения будут одного из этих типов

Используется в этих типах

ItemList

Примеры

Пример 1

Пример заметки или HTML разметки.


<ol>
  <li>
    <a href="https://example.com/dresses">Dresses</a>
  </li>
  <li>
    <a href="https://example.com/dresses/real">Real Dresses</a>
  </li>
</ol>

Пример, закодированный в формате Microdata, встроенный в HTML.


<ol itemscope itemtype="https://schema.org/BreadcrumbList">
  <li itemprop="itemListElement" itemscope
      itemtype="https://schema.org/ListItem">
    <a itemprop="item" href="https://example.com/dresses">
    <span itemprop="name">Dresses</span></a>
    <meta itemprop="position" content="1" />
  </li>
  <li itemprop="itemListElement" itemscope
      itemtype="https://schema.org/ListItem">
    <a itemprop="item" href="https://example.com/dresses/real">
    <span itemprop="name">Real Dresses</span></a>
    <meta itemprop="position" content="2" />
  </li>
</ol>

Пример, закодированный в формате RDFa, встроенный в HTML.


<ol vocab="https://schema.org/" typeof="BreadcrumbList">
  <li property="itemListElement" typeof="ListItem">
    <a property="item" typeof="WebPage" href="https://example.com/dresses">
     <span property="name">Dresses</span></a>
     <meta property="position" content="1">
  </li>
  <li property="itemListElement" typeof="ListItem">
    <a property="item" typeof="WebPage" href="https://example.com/dresses/real">
    <span property="name">Real Dresses</span></a>
    <meta property="position" content="2">
  </li>
</ol>

Пример, закодированный в формате JSON-LD в теге <script> HTML.


<script type="application/ld+json">
{
 "@context": "https://schema.org",
 "@type": "BreadcrumbList",
 "itemListElement":
 [
  {
   "@type": "ListItem",
   "position": 1,
   "item":
   {
    "@id": "https://example.com/dresses",
    "name": "Dresses"
    }
  },
  {
   "@type": "ListItem",
  "position": 2,
  "item":
   {
     "@id": "https://example.com/dresses/real",
     "name": "Real Dresses"
   }
  }
 ]
}
</script>

Структурированное представление примера JSON-LD.

@context

https://schema.org

@type

BreadcrumbList

itemListElement

0

@type

ListItem

position

item