Тип schema.org ?
Содержание: Описание, Свойства которые можно использовать, Подходит для свойств, Более специфичные типы, Примеры использования.
ListItem — это тип данных из словаря Schema.org, который используется для описания отдельных элементов списка. Представьте себе рецепт с пошаговыми инструкциями или подборку товаров на сайте. Чтобы сделать такую информацию понятной как для людей, так и для поисковых роботов, нужно четко структурировать каждый элемент. Именно здесь на помощь приходит ListItem.
Когда вы создаете контент, будь то список шагов в инструкции или перечень пунктов в обзоре, важно не просто выложить информацию, а организовать ее так, чтобы она была легко читаемой и логичной. ListItem помогает:
ListItem обычно используется в связке с другими типами Schema.org, такими как ItemList, HowTo, или BreadcrumbList. Он позволяет описать каждый элемент списка, указав его позицию, содержание и связи с соседними элементами.
Предположим, вы создаете пошаговую инструкцию по приготовлению пиццы. Вот как может выглядеть разметка с использованием 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 — это простой, но мощный инструмент для структурирования информации в виде списков. Он помогает сделать контент более понятным, удобным для пользователей и привлекательным для поисковых систем. Будь то рецепт, инструкция или навигация, правильное использование 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 | Ссылка на элемент списка, который предшествует текущему. |
Пример заметки или 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.