Встраивание публичных объектов
Вы можете встроить опубликованные дашборды и чарты на сайт или в приложение с помощью элемента iframe
.
Функциональность и внешний вид встраиваемых объектов можно определить с помощью передаваемых параметров:
-
_autoupdate
— задает время автообновления для дашбордов и чартов в секундах. По умолчанию они не обновляются автоматически. Работает только на активной вкладке браузера. Если для неактивной вкладки время автообновления уже наступило, оно выполнится, когда вкладка снова станет активной. Минимальная величина:- для дашбордов — 30 секунд;
- для чартов — 15 секунд.
-
_embedded
— скрывает панель навигации. Значение для включения параметра —1
. -
_no_controls
— у чартов скрывает меню . Значение для включения параметра —1
. -
_theme
— задает оформление объекта. Возможные значения:light
— для отображения в светлой теме;dark
— для отображения в темной теме.
-
_no_scroll
— выключает вертикальную прокрутку у дашборда. Значение для включения параметра —1
. -
_lang
— у чартов определяет значение языка для меню, которое открывается при нажатии на значок . Возможные значения:ru
илиen
. -
_opened_info
— при открытии дашборда отображает его описание, если оно заполнено. Значение для включения параметра —1
.
Параметры передаются в формате <имя_параметра>=<значение>
. Например, чтобы задать время автообновления 50 секунд, укажите: _autoupdate=50
.
Параметр добавляется к адресу объекта после знака вопроса ?
. Для передачи нескольких параметров перечислите их через знак амперсанда &
, например так:
<iframe frameborder="0" src="https://datalens.yandex/bdzix********?_embedded=1&_no_controls=1&_lang=ru&_theme=dark&_autoupdate=50"></iframe>
Примеры публичных встроенных чартов и дашбордов:
- Кинопоиск — публичная статистика оценок фильмов
и рейтинг фильмографии актеров. - Аудитория Яндекс Директа
— результат исследования Яндекса. - Каталог школ с прикрепленными домами
— сервис городских данных для родителей.
Получить код для вставки
Чтобы получить код для вставки с заданным оформлением дашборда или чарта:
- Опубликуйте дашборд или чарт.
- Откройте дашборд или чарт по полученной публичной ссылке.
- В правом верхнем углу нажмите значок
и выберите Код для вставки. - В открывшемся окне настройте язык, тему, отображение меню. В правой части окна скопируйте ссылку или код для вставки с заданными параметрами оформления.
Фильтрация встроенных чартов
К встроенным чартам можно применить фильтрацию. Для этого передайте параметры фильтрации в ссылке на чарт.
Чтобы задать параметры фильтрации:
- Добавьте чарт и селектор на дашборд.
- Опубликуйте дашборд.
- Задайте нужные значения селектора.
- У чарта на дашборде нажмите значок
и выберите Код для вставки. - В открывшемся окне настройте язык, тему, отображение меню. В правой части окна скопируйте ссылку или код для вставки с заданными параметрами оформления и параметрами фильтрации.
Параметры фильтрации добавятся к адресу чарта после знака вопроса ?
. При передаче более одного параметра, они будут перечислены через знак амперсанда &
.
<iframe frameborder="0" src="https://datalens.yandex/z2uxl5pbztkep?shopid_vj2j=sp-15&shopid_vj2j=sp-18&shopid_vj2j=sp-20&_embedded=1&_no_controls=1&_theme=light&_lang=ru" width="100%" height="400px"></iframe>