Проблемы и решения по разделу Компоненты

Для чего нужен этот документ

Этот документ нужен для ситуаций, когда компонент ведет себя не так, как ожидает сотрудник. Здесь собраны типовые симптомы и практический порядок разбора:

  • что именно выглядит как проблема
  • почему это обычно происходит
  • что проверить в интерфейсе
  • что делать дальше

Связанные документы по разделу:

Открывайте этот документ, если нужно:

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

Если нужен полный обзор раздела, вернитесь к:

Если нужен короткий ответ на типовой вопрос, открывайте:

Если проблема уже понятна и нужен рабочий маршрут, открывайте:

1. Компонент не сохраняется

Как выглядит проблема

Сотрудник заполнил карточку компонента, нажал Сохранить, но запись не проходит.

Почему так бывает

Чаще всего причина одна из следующих:

  • не заполнено Наименование
  • выбран не тот сценарий создания
  • не заполнены обязательные поля конкретного типа компонента
  • внутри вложенных элементов остались пустые обязательные строки

Что проверить

  • заполнено ли Наименование
  • корректно ли выбран тип компонента
  • нет ли незаполненных строк внутри галереи, меню, прайс-листа или другого сложного блока

Что делать

  1. Вернитесь в верхнюю часть карточки.
  2. Проверьте Наименование.
  3. Проверьте основную форму самого типа компонента.
  4. Удалите или заполните пустые вложенные строки.
  5. Повторите сохранение.

2. Выбран не тот тип компонента

Как выглядит проблема

Сотрудник открыл карточку и понял, что тип блока не соответствует задаче.

Почему так бывает

Тип выбирается в самом начале создания, и дальше карточка уже строится вокруг этого выбора.

Что проверить

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

Что делать

Если тип изначально выбран неверно, обычно правильнее создать новый компонент нужного типа и перенести работу в него.

3. Компонент создан, но покупатель его не видит

Как выглядит проблема

Карточка компонента существует и выглядит заполненной, но на экране блока нет.

Почему так бывает

Обычно причина одна из следующих:

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

Что проверить

  • активен ли компонент
  • добавлен ли он в нужный слот
  • открыта ли правильная страница
  • не перепутана ли зона страницы

Что делать

  1. Проверьте карточку компонента.
  2. Убедитесь, что компонент активирован.
  3. Откройте нужную страницу.
  4. Проверьте состав ее слотов.
  5. Добавьте или переместите компонент в нужную зону.

4. Компонент отображается, но стоит не в том месте

Как выглядит проблема

Блок на экране есть, но расположен не там, где ожидали.

Почему так бывает

Чаще всего проблема связана не с самим компонентом, а с:

  • неверным слотом
  • порядком компонентов внутри слота
  • общей структурой страницы

Что проверить

  • в какой слот добавлен компонент
  • какие блоки стоят выше и ниже
  • не используется ли для страницы другая базовая структура

Что делать

  1. Откройте страницу.
  2. Найдите нужный слот.
  3. Проверьте порядок компонентов в этой зоне.
  4. При необходимости измените состав и порядок блока на странице.
  5. Повторно проверьте экран.

5. На экране появились лишние повторы одного и того же блока

Как выглядит проблема

Один и тот же баннер, пункт меню или другой блок показывается несколько раз.

Почему так бывает

Обычно причина одна из следующих:

  • один и тот же компонент добавлен в несколько зон одной страницы
  • на странице есть дублирующийся похожий компонент
  • повтор идет через общую структуру страницы

Что проверить

  • сколько раз компонент добавлен на страницу
  • нет ли у него дублирующего аналога
  • не повторяется ли блок через общую основу экрана

Что делать

  1. Сравните состав компонентов на странице.
  2. Найдите повторяющийся блок.
  3. Оставьте один рабочий вариант.
  4. Лишний дубль удалите или отключите.

6. Компонент выглядит слишком крупно, мелко или неаккуратно

Как выглядит проблема

Блок есть, но выглядит не так, как ожидает команда:

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

Почему так бывает

Обычно проблема связана с:

  • базовым содержимым блока
  • дополнительными свойствами компонента
  • слишком грубыми ручными правками

Что проверить

  • содержимое самого блока
  • дополнительные свойства
  • не были ли внесены лишние настройки вручную

Что делать

  1. Сначала проверьте базовую форму компонента.
  2. Затем проверьте дополнительные свойства.
  3. Если правок слишком много, возвращайтесь к более простому варианту.
  4. Меняйте параметры по одному и каждый раз проверяйте результат на экране.

7. На одном устройстве компонент выглядит нормально, а на другом плохо

Как выглядит проблема

На одном экране блок выглядит аккуратно, а на другом:

  • ломается по размеру
  • читается хуже
  • выглядит слишком плотным

Почему так бывает

Чаще всего это связано с правилами для разных дисплеев или с отсутствием нужной подстройки под разные ширины экрана.

Что проверить

  • добавлены ли правила для разных диапазонов экранов
  • не конфликтуют ли они между собой
  • действительно ли блоку нужна отдельная настройка под разные дисплеи

Что делать

  1. Откройте карточку компонента.
  2. Проверьте раздел правил для разных дисплеев.
  3. Уберите лишние или противоречивые настройки.
  4. Оставьте только понятные и нужные корректировки.
  5. Снова проверьте блок на нескольких экранах.

8. После изменения компонента испортился сразу не один экран, а несколько

Как выглядит проблема

Команда правит один блок, а изменения замечает сразу на нескольких страницах.

Почему так бывает

Скорее всего, компонент используется повторно в нескольких местах.

Что проверить

  • не является ли компонент общим для нескольких страниц
  • не ожидала ли команда, что меняет только одну локальную копию

Что делать

  1. Определите, должен ли этот блок быть общим или отдельным.
  2. Если нужен отдельный вариант, создайте новый компонент.
  3. Разместите его только на нужной странице.
  4. Общий компонент оставьте для остальных экранов.

9. Компонент не удается сделать активным

Как выглядит проблема

Сотрудник включает Активирован, но сохранить блок в активном состоянии не получается.

Почему так бывает

Одна из типовых причин - достигнут лимит активных компонентов компании.

Что проверить

  • действительно ли нужен еще один активный блок
  • нет ли старых тестовых компонентов, которые уже можно отключить

Что делать

  1. Проверьте, какие компоненты уже остаются активными.
  2. Отключите лишние тестовые или неиспользуемые блоки.
  3. После этого снова попробуйте активировать нужный компонент.

10. Команда не понимает, создавать новый компонент или править старый

Как выглядит проблема

Сотрудники сомневаются, что безопаснее: изменить текущий блок или завести новый.

Почему так бывает

Чаще всего это происходит, когда:

  • текущий блок уже используется на нескольких страницах
  • будущий вариант похож, но не полностью совпадает

Что проверить

  • используется ли текущий компонент повторно
  • должен ли новый вариант полностью совпадать со старым

Что делать

Практическое правило простое:

  • если это тот же самый блок, его можно править
  • если смысл, содержимое или сценарий уже отличаются, лучше создать новый компонент