⚠️ Важно: данный сайт не имеет отношения к владельцам schema.org, это всего лишь любительский (неофициальный) перевод. Сайт сделан для тех, кто плохо воспринимает технический английский. Оригинал текста можно найти тут: schema.org/ListItem. Если сайт оказался полезен, то можете пожертвовать 50 рублей создателями сайта.

ListItem

Тип schema.org ?

Описание:

Элемент списка, например, шаг в контрольном списке или описание того, как что-то сделать.

Что такое ListItem и зачем он нужен?

ListItem — это тип данных из словаря Schema.org, который используется для описания отдельных элементов списка. Представьте себе рецепт с пошаговыми инструкциями или подборку товаров на сайте. Чтобы сделать такую информацию понятной как для людей, так и для поисковых роботов, нужно четко структурировать каждый элемент. Именно здесь на помощь приходит ListItem.

Почему ListItem важен?

Когда вы создаете контент, будь то список шагов в инструкции или перечень пунктов в обзоре, важно не просто выложить информацию, а организовать ее так, чтобы она была легко читаемой и логичной. ListItem помогает:

  • Улучшить восприятие. Пользователи быстрее находят нужную информацию, если она представлена в виде четкого списка.
  • Повысить SEO. Поисковые системы, такие как Google, могут использовать данные из ListItem для формирования расширенных сниппетов, которые привлекают больше внимания в результатах поиска.
  • Структурировать данные. Машины лучше понимают, как связаны элементы списка, что улучшает их обработку и представление.

Как работает ListItem?

ListItem обычно используется в связке с другими типами Schema.org, такими как ItemList, HowTo, или BreadcrumbList. Он позволяет описать каждый элемент списка, указав его позицию, содержание и связи с соседними элементами.

Основные свойства ListItem:

  • item: Ссылка на сам элемент списка (например, название шага или продукта).
  • position: Порядковый номер элемента в списке. Это помогает определить последовательность.
  • nextItem и previousItem: Указывают на следующий и предыдущий элементы в списке соответственно. Это особенно полезно для создания цепочек, например, в навигационных "хлебных крошках".

Пример использования

Предположим, вы создаете пошаговую инструкцию по приготовлению пиццы. Вот как может выглядеть разметка с использованием ListItem:

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "HowTo",
  "name": "Как приготовить пиццу",
  "step": [
    {
      "@type": "HowToStep",
      "@id": "#step1",
      "text": "Подготовьте тесто.",
      "position": 1
    },
    {
      "@type": "HowToStep",
      "@id": "#step2",
      "text": "Добавьте соус и начинку.",
      "position": 2,
      "previousItem": "#step1",
      "nextItem": "#step3"
    },
    {
      "@type": "HowToStep",
      "@id": "#step3",
      "text": "Выпекайте пиццу 15 минут.",
      "position": 3,
      "previousItem": "#step2"
    }
  ]
}
</script>

Здесь каждый шаг описан как отдельный элемент списка (ListItem), с указанием его позиции и связей с другими шагами.

Где еще применяется ListItem?

  1. Контрольные списки. Например, при описании этапов выполнения задачи.
  2. Товарные каталоги. Когда нужно представить список продуктов или услуг.
  3. Навигация. В "хлебных крошках" (BreadcrumbList) каждый уровень пути пользователя описывается как ListItem.
  4. FAQ. Вопросы и ответы можно структурировать как список элементов.

Преимущества использования ListItem

  1. Лучшая видимость в поиске. Поисковые системы могут использовать структурированные данные для создания "богатых" сниппетов, таких как пошаговые инструкции или списки часто задаваемых вопросов.
  2. Удобство для пользователей. Четкая структура помогает быстро найти нужную информацию.
  3. Международная совместимость. Разметка ListItem универсальна и поддерживается всеми основными поисковыми системами.

Советы по использованию

  1. Указывайте позицию. Свойство position обязательно для каждого элемента, чтобы сохранить логическую последовательность.
  2. Используйте связи. Если ваш список имеет порядок, добавьте nextItem и previousItem для лучшей навигации.
  3. Тестируйте разметку. Инструменты, такие как Google Rich Results Test, помогут проверить корректность данных.
  4. Не переусердствуйте. Используйте ListItem только там, где это действительно необходимо. Избыточная разметка может затруднить чтение кода.

Заключение

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

Свойство Ожидаемый тип Описание
Свойство из ListItem
item Thing Сущность, представленная записью в списке или потоке данных (например, 'артист' в списке 'артистов').
nextItem ListItem Ссылка на элемент списка, который следует за текущим.
position Integer, Text Позиция элемента в серии или последовательности элементов.
previousItem ListItem Ссылка на элемент списка, который предшествует текущему.
Свойство из Thing
additionalType URL, Text Дополнительный тип для элемента, обычно используемый для добавления более специфичных типов из внешних словарей в синтаксисе микроданных. Это отношение между чем-то и классом, к которому это что-то относится. Обычно значение является URI-идентифицированным классом RDF, и в этом случае соответствует использованию rdf:type в RDF. Текстовые значения могут использоваться экономно, в случаях, когда полезная информация может быть добавлена без наличия соответствующей схемы для ссылки. В случае текстовых значений, метка класса должна следовать руководству по стилю schema.org.
alternateName Text Псевдоним для элемента.
description Text, TextObject Описание предмета.
disambiguatingDescription Text Субсвойство описания. Краткое описание элемента, используемое для различения его от других, похожих элементов. Информация из других свойств (в частности, имени) может быть необходима для того, чтобы описание было полезным для различения.
identifier PropertyValue, Text, URL Свойство identifier представляет собой любой вид идентификатора для любого рода Thing, такого как ISBN, коды GTIN, UUID и т.д. Schema.org предоставляет специальные свойства для представления многих из них, как в виде текстовых строк, так и в виде ссылок URL (URI). См. фоновую информацию для получения дополнительных деталей.
image ImageObject, URL Изображение предмета. Это может быть URL или полностью описанный ImageObject.
mainEntityOfPage CreativeWork, URL Указывает на страницу (или другое творческое произведение), для которой этот объект является основным описываемым объектом. См. фоновую информацию для получения деталей.
name Text Название элемента.
potentialAction Action Указывает на потенциальное действие, которое описывает идеализированное действие, в котором этот объект будет играть роль 'объекта'.
sameAs URL URL страницы в Интернете, которая однозначно указывает на идентичность элемента. Например, URL страницы элемента в Википедии, запись в Викиданных или официальный сайт.
subjectOf CreativeWork, Event Творческое произведение или событие, связанное с этой вещью.
url URL URL предмета.

Экземпляры ListItem могут использоваться в качестве значения для следующих свойств.

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

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

Примечание: Порядок элементов в вашей разметке недостаточен для указания порядка элементов. В таких случаях используйте ListItem с свойством 'position'.
negativeNotes Review, Product Предоставляет негативные соображения относительно чего-либо, чаще всего в списках "за" и "против" для отзывов (наряду с positiveNotes). Для симметрии

В случае Отзыва это свойство описывает предмет отзыва с точки зрения отзыва; в случае Продукта описывается сам продукт. Поскольку описания продуктов, как правило, акцентируют внимание на положительных характеристиках, может быть относительно необычно встречать negativeNotes в таком контексте. Тем не менее, ради симметрии negativeNotes может использоваться для Продукта.

Значения свойства могут быть выражены как в неструктурированном тексте (при необходимости повторяемом), так и в виде списка (в этом случае самый негативный элемент будет в начале списка).
nextItem ListItem Ссылка на элемент списка, который следует за текущим.
positiveNotes Review, Product Предоставляет положительные соображения относительно чего-либо, например, основные преимущества продукта или (вместе с negativeNotes) списки "за" и "против" для обзоров.

В случае обзора свойство описывает объект обзора с точки зрения обзора; в случае продукта описывается сам продукт.

Значения свойства могут быть выражены как в виде неструктурированного текста (при необходимости повторяемого), так и в виде упорядоченного списка (в этом случае самый положительный элемент находится в начале списка).
previousItem ListItem Ссылка на элемент списка, который предшествует текущему.

Более специфичные типы

Примеры

Пример 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
1
item
@id
https://example.com/dresses
name
Dresses
1
@type
ListItem
position
2
item
@id
https://example.com/dresses/real
name
Real Dresses
Автор: Семён Авдосов [schema.su]
Дата публикации: 16.11.2024
Дата обновления: 18.03.2025
Комментарии
Новые материалы на сайте