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

@id: https://example.com/dresses
name: Dresses

1

@type

ListItem

position

item

@id: https://example.com/dresses/real
name: Real Dresses

Пример 2

Это пример от schema.su, его нету в официальной документации! Будьте внимательны, работоспособность не можем гарантировать. Проверяйте через валидатор.

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

<div>
  <h2>Необходимые материалы и инструменты</h2>
  <ul>
    <li><strong>Лампочка накаливания</strong>, количество: 1 шт.</li>
    <li><strong>Стул или стремянка</strong>, количество: 1 шт.</li>
  </ul>
  <p>Для выполнения простой задачи — замены перегоревшей лампочки — потребуются эти предметы.</p>
</div>

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

<div itemscope itemtype="https://schema.org/HowToSection">
  <h2 itemprop="name">Материалы и инструменты</h2>
  <div itemprop="itemListElement" itemscope itemtype="https://schema.org/HowToItem">
    <p>
      <strong>Название:</strong> <span itemprop="name">Лампочка накаливания</span><br>
      <strong>Количество:</strong> <span itemprop="requiredQuantity">1 шт.</span>
    </p>
  </div>
  <div itemprop="itemListElement" itemscope itemtype="https://schema.org/HowToItem">
    <p>
      <strong>Название:</strong> <span itemprop="name">Стул или стремянка</span><br>
      <strong>Количество:</strong> <span itemprop="requiredQuantity">1 шт.</span>
    </p>
  </div>
  <p itemprop="description">Для выполнения простой задачи — замены перегоревшей лампочки — потребуются эти предметы.</p>
</div>

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

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "HowToSection",
  "name": "Материалы и инструменты",
  "description": "Для выполнения простой задачи — замены перегоревшей лампочки — потребуются эти предметы.",
  "itemListElement": [
    {
      "@type": "HowToItem",
      "name": "Лампочка накаливания",
      "requiredQuantity": "1 шт."
    },
    {
      "@type": "HowToItem",
      "name": "Стул или стремянка",
      "requiredQuantity": "1 шт."
    }
  ]
}
</script>

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

@context

https://schema.org

@type

HowToSection

name

Материалы и инструменты

description

Для выполнения простой задачи — замены перегоревшей лампочки — потребуются эти предметы.

itemListElement

0