BRD Widget 8.2.1 Кастомизация виджета
Направление работ: Widget Код раздела: 8.2.1 Раздел: Общие работы > Интеграция виджета партнером > Кастомизация виджета Статус: черновик Ответственный: Панкова Л.А. Версия: 0.1 Обновлено: 21.07.26
1. Назначение
Раздел описывает кастомизацию виджета партнёром: акцентный цвет, вариант компоновки, положение календаря и скрытие блока информации о площадке.
Партнёр задаёт параметры в кабинете, виджет применяет их из конфигурации при загрузке. Сам выбор темы (светлая/тёмная/системная) описан в разделе 8.5.
Документ описывает применение кастомизации на стороне виджета. Механизм тёмной темы — раздел 8.5; встраивание — раздел 8.2; настройка параметров партнёром в кабинете — WebLk 3.8.
2. Ключевые понятия
Конфигурация виджета — набор параметров партнёра, которые виджет получает по идентификатору и применяет при загрузке.
Акцентный цвет — цвет оформления виджета (отдельно для светлой и тёмной темы).
Вариант компоновки — режим отображения виджета: по партнёрской зоне, по объекту или по площадке.
Положение календаря — размещение календаря выше или ниже блока площадки.
3. Scope
Входит
S1: Применение акцентного цвета
S2: Применение варианта компоновки
S3: Положение календаря и скрытие блока информации о площадке
S4: Переопределение темы и акцента от родительской страницы
Не входит
- Widget: 8.5 Общие работы > Темная тема (механизм светлой/тёмной/системной темы)
- Widget: 8.2 Общие работы > Интеграция виджета партнером
- WebLk: 3.8 Инструменты настройка параметров кастомизации партнёром
4. BR
Параметры кастомизации задаются партнёром в WebLk: 3.8 Инструменты; виджет их применяет.
5. Функциональные требования (UC + FR)
FR — functional requirements, что интерфейс должен уметь делать по определенному UC.
| ID | Сценарий | Функциональное требование | BR | Вес | Статус |
|---|---|---|---|---|---|
| S1: #FR8.2.1-1 | Виджет загружается с настройками партнёра | Виджет применяет акцентный цвет из конфигурации, отдельно для светлой и тёмной темы. | 2 | ||
| S2: #FR8.2.1-2 | Виджет применяет компоновку | Виджет применяет вариант компоновки из конфигурации: по партнёрской зоне, по объекту или по площадке. | 1 | ||
| S3: #FR8.2.1-3 | Виджет применяет расположение | Виджет размещает календарь выше или ниже блока площадки и может скрывать блок информации о площадке в соответствии с конфигурацией. | 2 | ||
| S1: #FR8.2.1-5 | Виджет получает настройки партнёра | Виджет применяет настройки, приходящие в конфигурации партнёрской зоны. Полный перечень настраиваемых параметров: привязка — партнёрская зона, объект, площадка; вариант отображения календаря (widgetType) — по зоне, по объекту или по площадке; формат работы (widgetFormat) — с регистрацией или без; тема (theme) — системная, светлая или тёмная; цвета — акцентный и цвет действия, отдельно для светлой и тёмной темы; компоновка (calendarFirst) — календарь выше или ниже блока площадки; скрытие блока площадки (noInfo); горизонт бронирования в днях (limitDays); разрешённые домены (whiteList). Иных параметров кастомизации виджет не поддерживает. | 1 | Реализовано — параметры разбираются конфигурацией; widgetFormat доезжает, но не используется, см. Widget: 4.1 OQ4.1-2 | |
| S4: #FR8.2.1-4 | Родительская страница переопределяет оформление | Виджет поддерживает переопределение темы и акцентного цвета сообщениями от родительской страницы (mb-theme, mb-accent). | 3 |
6. Открытые вопросы
| ID | Источник | Вопрос | Кому | Статус |
|---|---|---|---|---|
| #OQ8.2.1-1 | Figma / продукт | Подтвердить полный перечень кастомизируемых параметров виджета (акцент, компоновка, положение календаря, скрытие блока площадки, тема) и место их настройки: часть задаётся в кабинете партнёра и на бэкенде, вне репозитория виджета. Решение: перечень подтверждён как полный — он зафиксирован в FR8.2.1-5 по фактическому составу конфигурации партнёрской зоны, которую читает виджет. Дополнительных параметров кастомизации не предполагается. \ shared/api/widget-config/api/widgetConfig.api.ts:88-105 | Бизнес | Закрыт |