Документация

Свойства виджета

Свойства виджета содержат информацию:

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

Конечный пользователь не может влиять на свойства виджета, так как в них содержится информация, специфичная для класса виджета в целом, а не для его отдельного экземпляра.

Свойства необходимо помещать в блок <head> XHTML-файла виджета. Каждое свойство описывается отдельно внутри собственного тега meta. Например:

<head>
  <meta name="title" content="Hello, world!" />
  <meta name="..." content="..." />
    ...
</head>

Атрибуты тега meta

АтрибутЗначение
name Название свойства виджета. Значение атрибута name должно совпадать с названием одного из свойств виджетов.
content Значение свойства, указанного в атрибуте name. Допустимые значения зависят от типа свойства.
Примечание. Оба атрибута являются обязательными.

Свойства виджета

Обязательные: необходимы для загрузки виджета на Яндекс
СвойствоЗначение
title Заголовок виджета.
Рекомендуемые: необходимы для добавления виджета в каталог
СвойствоЗначение
description Описание функций виджета.
titleURL Адрес сайта, связанного с содержимым виджета. Например, сайт разработчика или сайт сервиса, доступ к которому предоставляет виджет.
Необязательные
СвойствоЗначение
src Адрес тела серверного виджета. Подробнее см. Автономные и серверные виджеты.
height Высота <iframe>, в котором отображается виджет (в пикселах). Значение по умолчанию: 300.
language

Код языка виджета (в соответствии со стандартом ISO 639-1). По умолчанию соответствует языку разработчика.

Если виджет поддерживает несколько языков, то их коды перечисляются через точку с запятой.

метаданные