steelmorgan/form-visual-requirements

Визуальные требования к формам

Используй этот чек-лист для проверки форм 1С.

Перед оценкой изображения проверь, что PNG не пустой и не одноцветный/чёрный. Как получать скриншот формы, как действовать в Xvfb и когда допустим browser fallback — см. профильный навык va-visual-check.

1. Разметка и выравнивание

• [ ] Выравнивание: элементы выровнены по сетке, без эффекта «лесенки».
• [ ] Группировка: логически связанные поля объединены в группы (рамка, страница).
• [ ] Пустоты: нет больших пустых областей (>150px), если это не задумано.
• [ ] Ширина полей:
  • Код, Номер, Дата — узкие.
  • Описание, Комментарий, Адрес — широкие (растянуты).
  • Колонки табличных частей — «Авто ширина» или явная ширина для заполнения пространства.

2. Элементы и подписи

• [ ] Подписи: у всех полей есть подписи (или явно указано TitleLocation=None).
• [ ] Обрезание: подписи и значения не должны обрезаться троеточием («…») при наличии места.
• [ ] Надписи флажков: подпись флажка должна быть понятной (например, «Активен», а не просто чекбокс).
• [ ] Командная панель: меню «Ещё» не должно скрывать основные действия.

3. Удобство использования

• [ ] Порядок табуляции: фокус перемещается слева направо и сверху вниз.
• [ ] Ключевые поля: важные идентификаторы (Наименование, Код, Дата) — в левом верхнем углу.
• [ ] Табличные части: разумная высота (минимум 5–10 видимых строк).
• [ ] Горизонтальная прокрутка: строго запрещена для основной области формы (вертикальная допускается).
• [ ] Ширина по смыслу: короткие коды, номера, даты и флаги не растянуты; длинные комментарии и адреса многострочные.
• [ ] Основное действие: на форме есть не больше одной основной команды по умолчанию, если сценарий не требует нескольких равнозначных действий.
• [ ] Диалоги: вопрос объясняет последствия; кнопка подтверждения называет действие (Удалить строки, Провести, Записать), а не только Да.
• [ ] Ссылки и кнопки: гиперссылки открывают форму/раздел/справку; действия с данными выполняются кнопками.
• [ ] Флажки: подписи флажков формулируют включаемое поведение без отрицаний.

4. Специфика по типам объектов

Справочники

• Код/Наименование обычно сверху.
• Поле родителя (при иерархии) — заметное.

Документы

• Дата/Номер — вверху.
• Статус/Организация/Склад — в заголовке.
• Табличные части — в теле формы.
• Итоги/Комментарий/Автор — внизу.
• Для табличной части виден понятный заголовок; если заголовок показывает количество строк, проверяй ПутьКДаннымЗаголовка.

Обработки

• Настройки/параметры — сверху или на отдельной вкладке.
• Кнопки действий — в командной панели или справа внизу.

5. Platform Properties

• [ ] Команды, меняющие сохраняемые данные, имеют ИзменяетСохраняемыеДанные.
• [ ] Обязательные реквизиты используют ПроверкаЗаполнения, если обязательность не зависит от сложного бизнес-условия.
• [ ] Форма списка содержит ГруппаПользовательскихНастроек, если пользовательские отборы должны быть видимы.
• [ ] В типовой форме новые реквизиты размещены программно: на служебной вкладке или в служебной группе, если ТЗ не задает точное место.
• [ ] Видимость/доступность элементов выглядит согласованно; в модуле формы это должно соответствовать централизованной процедуре обновления.

depends_on: []