ListItem

Тип schema.org ?

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

Содержание: Описание, Свойства которые можно использовать, Подходит для свойств, Более специфичные типы, Примеры использования.

Описание:

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

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

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

ListItem часто применяется в контексте других типов Schema.org, таких как HowTo или ItemList. Он может включать такие свойства, как "position" (позиция в списке) и "item" (ссылка на сам элемент). Это помогает указать порядок элементов и их содержание.

Использование 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

item