[Документация Yandex Cloud](../../../index.md) > [Yandex DataLens](../../index.md) > Дашборды > Пошаговые инструкции > Виджеты на дашборде > Добавление селектора на дашборд # Добавление селектора на дашборд в Yandex DataLens Перед добавлением селектора убедитесь, что у вас есть право доступа `Редактирование` или `Администрирование` на дашборд. Подробнее в разделе [Права доступа к объектам](../../security/manage-access.md). Чтобы добавить [селектор](../../dashboard/selector.md) на дашборд: {% note warning %} Если вы работаете с новой объектной моделью DataLens, включающей [воркбуки и коллекции](../../workbooks-collections/index.md): 1. На панели слева выберите ![collections](../../../_assets/console-icons/rectangles-4.svg) **Коллекции и воркбуки**. 1. Откройте нужный воркбук и выберите объект. Продолжайте инструкцию с шага 2. {% endnote %} 1. На панели слева нажмите ![image](../../../_assets/console-icons/layout-cells-large.svg) **Дашборды** и выберите нужный дашборд. 1. В верхней части страницы нажмите кнопку **Редактировать**. 1. На панели в нижней части страницы зажмите ![image](../../../_assets/console-icons/sliders.svg) **Селектор** и перетащите его в нужную область. ![image](../../../_assets/datalens/operations/widget-select-js.png =650x95) 1. На вкладке **Селекторы** выберите источник и укажите настройки селектора: {% list tabs %} - На основе датасета * **Датасет** — датасет с данными для селектора. Можно выбрать датасет из списка объектов или указать ссылку. Обязательно для заполнения. * **Поле** — поле датасета со значениями селектора. Может быть как измерением, так и показателем (подробнее в [Поля данных](../../dataset/data-model.md#field)). Обязательно для заполнения. * **Показать на вкладках** — выберите, как селектор будет отображаться на дашборде: * `Текущая вкладка <название_вкладки>` (по умолчанию для одиночного селектора) — селектор будет отображаться на указанной вкладке. * `Выбранные вкладки` — отметьте одну или несколько вкладок, на которых нужно отображать селектор. По умолчанию отмечена текущая вкладка. * `Все вкладки` — селектор будет отображаться на всех вкладках. Доступно для одиночного селектора. * `Из настроек группы <значение_для_группы>` (по умолчанию для селектора в группе) — селектор будет отображаться так, как указано в расширенных настройках виджета с группой селекторов. Доступно только для селектора в группе. * Кнопка ![image](../../../_assets/console-icons/magnifier.svg). Отображается справа от настройки **Показать на вкладках** при заполненной настройке **Поле**. Позволяет найти и объединить селекторы с таким же полем или параметром на других вкладках. Чтобы объединить текущий селектор с найденным, нажмите кнопку **Объединить** напротив нужного селектора в списке найденных. После объединения может автоматически измениться настройка **Показать на вкладках** у текущего селектора, например: * значение `Текущая вкладка` поменяется на `Выбранные вкладки`, и будут отмечены вкладки, на которых расположены объединяемые селекторы; * значение `Выбранные вкладки` останется без изменений, но в списке отмеченных появится вкладка с добавляемым селектором, если она не была отмечена ранее; * значение `Все вкладки` останется без изменений. Связи добавляемого селектора в пределах его вкладки применятся к текущему селектору в пределах соответствующей вкладки. * **Тип селектора** — выпадающий список, поле ввода, календарь или чекбокс. {% note info %} * **Календарь** доступен только для полей с типом `Дата` или `Дата и время`. * **Чекбокс** доступен только для полей с типом `Логический`. * Для показателей доступен только тип селектора **Поле ввода**. {% endnote %} * **Операция** — операция сравнения, по которой селектор фильтрует значения чарта (например, **Равно**, **Больше** или **Меньше**). Если оставить поле пустым, селектор по умолчанию будет фильтровать по операции **Равно**. Список доступных операций зависит от типа поля. {% note info %} Не указывайте операцию, если селектор: * будет фильтровать QL-чарт; * связан с параметрами чарта или датасета. {% endnote %} * **Множественный выбор** — опция позволяет выбирать несколько значений в селекторе. Доступно только для селекторов типа **Список**. * **Диапазон** — опция позволяет выбирать временной промежуток в селекторе. Доступно только для селекторов типа **Календарь**. * **Обязательное поле** — делает значение селектора обязательным для заполнения. При включенной опции в конце названия селектора добавляется `*`. Недоступно для селектора типа **Чекбокс**. * **Значение по умолчанию** — отображается изначально при открытии дашборда. Обязательно для заполнения при включенной опции **Обязательное поле**. * **Заголовок** — используется для выбора селектора при установлении связи с другими виджетами. По умолчанию при добавлении селектора текст названия подставляется из названия поля в [датасете](../../dataset/index.md). Обязательно для заполнения. Ниже выберите расположение заголовка: `Слева` (по умолчанию), `Сверху` или `Скрыт`, чтобы не отображать его на дашборде. Недоступно в селекторах типа **Чекбокс**. * **Внутренний заголовок** — позволяет указать текст внутри селектора. Например, его можно использовать для отображения операции внутри селектора. Недоступен в селекторах типа **Чекбокс**. * **Цветовой акцент** — опция позволяет выделить цветом важные селекторы. Недоступно в селекторах типа **Чекбокс**. * **Подсказка** — опция позволяет добавить текстовое пояснение к селектору. По умолчанию при включении опции текст пояснения подставляется из описания поля в датасете. Вы можете изменить текст подсказки и использовать для этого визуальный редактор или разметку [Markdown](../../dashboard/markdown.md). При изменении описания поля в датасете текст не обновляется автоматически. Когда опция включена, на дашборде рядом с селектором появляется значок ![image](../../../_assets/console-icons/circle-question.svg). При наведении курсора на значок отображается всплывающая подсказка. - Ручной ввод * **Поле или параметр** — имя поля, по которому можно установить связь селектора с другими виджетами в окне настройки [алиаса](../../dashboard/link.md#alias). Обязательно для заполнения. * **Показать на вкладках** — выберите, как селектор будет отображаться на дашборде: * `Текущая вкладка <название_вкладки>` (по умолчанию для одиночного селектора) — селектор будет отображаться на указанной вкладке. * `Выбранные вкладки` — отметьте одну или несколько вкладок, на которых нужно отображать селектор. По умолчанию отмечена текущая вкладка. * `Все вкладки` — селектор будет отображаться на всех вкладках. Доступно для одиночного селектора. * `Из настроек группы <значение_для_группы>` (по умолчанию для селектора в группе) — селектор будет отображаться так, как указано в расширенных настройках виджета с группой селекторов. Доступно только для селектора в группе. * Кнопка ![image](../../../_assets/console-icons/magnifier.svg). Отображается справа от настройки **Показать на вкладках** при заполненной настройке **Поле или параметр**. Позволяет найти и объединить селекторы с таким же полем или параметром на других вкладках. Чтобы объединить текущий селектор с найденным, нажмите кнопку **Объединить** напротив нужного селектора в списке найденных. После объединения может автоматически измениться настройка **Показать на вкладках** у текущего селектора, например: * значение `Текущая вкладка` поменяется на `Выбранные вкладки`, и будут отмечены вкладки, на которых расположены объединяемые селекторы; * значение `Выбранные вкладки` останется без изменений, но в списке отмеченных появится вкладка с добавляемым селектором, если она не была отмечена ранее; * значение `Все вкладки` останется без изменений. Связи добавляемого селектора в пределах его вкладки применятся к текущему селектору в пределах соответствующей вкладки. * **Тип селектора** — выпадающий список, поле ввода, календарь или чекбокс. {% note info %} * **Календарь** доступен только для полей с типом `Дата` или `Дата и время`. * **Чекбокс** доступен только для полей с типом `Логический`. * Для показателей доступен только тип селектора **Поле ввода**. {% endnote %} * **Операция** — операция сравнения, по которой селектор фильтрует значения чарта (например, **Равно**, **Больше** или **Меньше**). Если оставить поле пустым, селектор по умолчанию будет фильтровать по операции **Равно**. Список доступных операций зависит от типа поля. {% note info %} Не указывайте операцию, если селектор: * будет фильтровать QL-чарт; * связан с параметрами чарта или датасета. {% endnote %} * **Обязательное поле** — делает значение селектора обязательным для заполнения. При включенной опции в конце названия селектора добавляется `*`. Недоступно для селектора типа **Чекбокс**. * **Множественный выбор** — опция позволяет выбирать несколько значений в селекторе. Доступно только для селекторов типа **Список**. * **Возможные значения** — список значений для выбора. Доступно только для селекторов типа **Список**. Чтобы добавить сразу несколько значений, скопируйте список значений в буфер, вставьте его в поле ввода и нажмите кнопку **Добавить**. Вы также можете удалить значение, нажав ![image](../../../_assets/console-icons/xmark.svg), или поменять значения местами, перетащив их. * **Диапазон** — опция позволяет выбирать временной промежуток в селекторе. Доступно только для селекторов типа **Календарь**. * **Время** — опция позволяет указывать время. Доступно только для селекторов типа **Календарь**. * **Значение по умолчанию** — отображается изначально при открытии дашборда. Обязательное поле для селектора типа **Список**: если его не заполнить, в селекторе не будет доступно ни одного значения. Обязательно для заполнения при включенной опции **Обязательное поле**. * **Заголовок** — используется для выбора селектора при установлении связи с другими виджетами. Обязательно для заполнения. Ниже выберите расположение заголовка: `Слева` (по умолчанию), `Сверху` или `Скрыт`, чтобы не отображать его на дашборде. Недоступно в селекторах типа **Чекбокс**. * **Внутренний заголовок** — позволяет указать текст внутри селектора. Например, его можно использовать для отображения операции внутри селектора. Недоступен в селекторах типа **Чекбокс**. * **Цветовой акцент** — опция позволяет выделить цветом важные селекторы. Недоступно в селекторах типа **Чекбокс**. * **Подсказка** — опция позволяет добавить текстовое пояснение к селектору. По умолчанию при включении опции текст пояснения подставляется из описания поля в [датасете](../../dataset/index.md). Вы можете изменить текст подсказки. При изменении описания поля в датасете текст не обновляется автоматически. Когда опция включена, на дашборде рядом с селектором появляется значок ![image](../../../_assets/console-icons/circle-question.svg). При наведении курсора на значок отображается всплывающая подсказка. {% endlist %} Для [QL-чартов](../../concepts/chart/ql-charts.md) в области редактирования чарта на вкладке **Параметры** можно управлять [параметрами селектора](../chart/create-sql-chart.md#selector-parameters), а на вкладке **Запрос** указывать переменную в самом запросе в `not_var{{variable}}` формате. 1. (опционально) Добавьте еще один селектор в виджет. Для этого на вкладке **Селекторы** слева нажмите кнопку ![image](../../../_assets/console-icons/plus.svg) **Добавить** и повторите действия из предыдущего шага. Также вы можете продублировать созданный селектор или скопировать его в буфер обмена. Для этого на вкладке **Селекторы** напротив селектора нажмите значок ![image](../../../_assets/console-icons/ellipsis.svg) и выберите: * **Дублировать** — в виджет добавится новый селектор с такими же параметрами; * **Копировать в буфер** — вы можете вставить скопированный селектор в другой виджет с помощью кнопки **Вставить** на вкладке **Селекторы** или на дашборд с помощью кнопки **Вставка** на панели в нижней части страницы дашборда. 1. (опционально) Перейдите на вкладку **Настройки группы** и укажите настройки виджета: * **Кнопка «Применить»** — добавляет для виджета кнопку, которая применяет значения всех селекторов в виджете. До нажатия кнопки значения селекторов не применяются. * **Кнопка «Сбросить»** — добавляет для виджета кнопку, которая сбрасывает значения всех селекторов в виджете до значений по умолчанию. * **Фон** — задает цвет фона и прозрачность виджета отдельно для светлой и темной темы. * **Скругление** — задает скругление виджета. * **Автовысота** — включает автоматическую высоту для виджета на дашборде. Доступно для виджета с несколькими селекторами. * (опционально) Для виджета с несколькими селекторами в поле **Показать на вкладках** выберите, как селектор будет отображаться на дашборде: * `Текущая вкладка <название_вкладки>` (по умолчанию) — селектор будет отображаться на указанной вкладке. * `Выбранные вкладки` — отметьте одну или несколько вкладок, на которых нужно отображать селектор. По умолчанию отмечена текущая вкладка. * `Все вкладки` — селектор будет отображаться на всех вкладках. Настройка становится доступной при добавлении в виджет второго селектора: * Значение настройки первого селектора автоматически становится значением настройки группы. Вы можете поменять его в любой момент. * Для каждого нового селектора в группе значение по умолчанию — `Из настроек группы <значение_для_группы>`. При использовании настройки обратите внимание: * Нельзя сохранить селектор со значением настройки, при которой на текущей вкладке не отображается ни одного селектора. Например, если для одиночного селектора выбрано значение `Выбранные вкладки`, то можно снять отметку с текущей вкладки, но при этом нельзя сохранить селектор. * Нельзя сохранить селектор со значением настройки `Выбранные вкладки`, если не выбрана ни одна из вкладок. * Настройка группы ограничивает настройку каждого селектора в группе. Например, если для группы выбрано значение `Текущая вкладка`, для селекторов этой группы тоже должна быть выбрана `Текущая вкладка`. | **Настройка группы** | **Настройка селектора** | |----------------------|---------------------| | `Все вкладки` | `Текущая вкладка`, `Выбранные вкладки`, `Все вкладки` | | `Выбранные вкладки` | `Текущая вкладка`, `Выбранные вкладки` | | `Текущая вкладка` | `Текущая вкладка` | * При удалении селектора на текущей вкладке он автоматически удаляется на всех вкладках. * При копировании и вставке селектора настройка сохраняется. * Нельзя вставить скопированный селектор, если настройка делает невозможным его отображение на текущей вкладке. * (опционально) Для виджета с несколькими селекторами настройте расположение селекторов. Для этого расположите селекторы в нужном порядке, перетаскивая их, и настройте ширину для каждого селектора: * `Авто` — автоматическая ширина селектора; * `%` — ширина селектора в процентах от общей ширины виджета; * `px` — ширина селектора в пикселях. Нажмите **Сохранить**. ![image](../../../_assets/datalens/selector-settings/selector-extending-settings.png =679x544) 1. Нажмите кнопку **Сохранить**. Виджет отобразится на дашборде. {% note warning %} При добавлении селектора по полю на дашборд фильтры, добавленные на уровне чарта, перестают применяться к графику на дашборде. {% endnote %} ## Ограничения {#restrictions} * Для селекторов по показателям доступен только один тип — **Поле ввода**. * Селекторы по показателям рекомендуется делать только независимыми от других селекторов. Для этого задайте для них тип [связи](../../dashboard/link.md) **Не связаны** с другими селекторами в разделе **Связи** при редактировании дашборда. ## Копирование и вставка селекторов {#copy-paste} Вы можете скопировать уже созданный селектор и вставить его на дашборд. При копировании селектора с одной вкладки и вставке его на другую вкладку текущего дашборда можно связать его с исходным селектором или создать новый независимый селектор. Копирование и вставка виджета и JS-селектора в общем случае происходит так же, как и отдельного селектора. Чтобы скопировать селектор с дашборда: 1. На панели слева нажмите ![image](../../../_assets/console-icons/layout-cells-large.svg) **Дашборды** и выберите нужный дашборд. 1. В верхней части страницы нажмите кнопку **Редактировать**. 1. У нужного виджета на дашборде нажмите ![image](../../../_assets/console-icons/ellipsis.svg) → ![image](../../../_assets/console-icons/copy.svg) **Копировать**. Чтобы вставить на дашборд скопированный селектор: 1. На панели слева нажмите ![image](../../../_assets/console-icons/layout-cells-large.svg) **Дашборды** и выберите нужный дашборд. 1. В верхней части страницы нажмите кнопку **Редактировать**. 1. Выберите вкладку, на которую хотите вставить виджет. 1. На панели в нижней части страницы зажмите ![image](../../../_assets/console-icons/copy-plus.svg) **Вставка** и перетащите виджет в нужную область. Чтобы вставить виджет внизу дашборда, просто нажмите ![image](../../../_assets/console-icons/copy-plus.svg) **Вставка**. Если вы пытаетесь вставить селектор на другую вкладку текущего дашборда, выберите: * **Изменить настройки** — после вставки автоматически изменится настройка **Показать на вкладках** у исходного селектора: * значение `Текущая вкладка` поменяется на `Выбранные вкладки`, и будут отмечены вкладки, на которых расположены исходный и добавляемый селекторы; * значение `Выбранные вкладки` останется без изменений, но в списке отмеченных появится вкладка с добавляемым селектором, если она не была отмечена ранее. * **Скопировать** или закройте окно — на текущей вкладке будет создан независимый селектор. Если селектор был скопирован с текущей вкладки, будет создан независимый селектор. Если текущая вкладка уже была отмечена ранее в настройке **Показать на вкладках**, будет создан независимый селектор. 1. Измените размер виджета и переместите его в удобное место на странице. 1. В правом верхнем углу дашборда нажмите кнопку **Сохранить**.