3.6. Переход на обновленный интерфейс: типовые проблемы и решения

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

После перехода на обновленный интерфейс начиная с версии AS - 1.26.0-rc13 могут проявиться возможные проблемы в формах и компоновках, рассчитанных под старые размеры элементов UI. Основные причины таких проблем: увеличение размеров шрифтов, редакторов и внутренних отступов.

3.6.1. Возможные проблемы

3.6.1.1. Модальная форма обрезана

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

Типовые признаки проблемы:

  • элементы внутри окна визуально сжимаются по горизонтали;

  • кнопки или нижняя часть формы обрезаются;

  • часть содержимого перестаёт помещаться по высоте или ширине.

Что рекомендуется проверить:

  1. Проверить, используются ли у формы свойства размера formSize.fixed, formSize.height и formSize.width.

  2. Если размеры были подобраны под старый интерфейс, пересмотреть их под текущую плотность UI.

  3. В первую очередь проверить фиксированную высоту, так как именно она чаще всего приводит к сжатию контента и кнопок.

  4. Если жёсткая фиксация размера не обязательна, отдельно оценить необходимость использования formSize.fixed.

3.6.1.2. Интерфейс перестал помещаться

Если после перехода на обновленный интерфейс проблема наблюдается массово по прикладному решению, а не только в нескольких отдельных формах, можно рассмотреть настройку Configuration.Client.Ui.density.

Использование Компактной плотности UI (значение compact) позволяет вернуть интерфейс к более плотной компоновке и компенсировать увеличение размеров элементов после редизайна.

Note

Обычная плотность UI (Configuration.Client.Ui.UiDensity.normal) остаётся рекомендуемым вариантом по умолчанию. Компактную плотность UI не стоит использовать как замену прикладной корректировке единичных форм. Если непопадание по размерам наблюдается точечно, базовая рекомендация - корректировать размеры и компоновку конкретных форм или окон.

Настройка Configuration.Client.Ui.density доступна, начиная с версии AS - 1.26.0-rc13. При этом для сценария миграции на обновленный интерфейс рекомендуется использовать версию сервера не ниже 1.26.0-rc18, так как в ней уже учтены дополнительные улучшения по уплотнению интерфейса.

3.6.2. Часто задаваемые вопросы

Почему модальная форма стала тесной после перехода на обновленный интерфейс?

В новом интерфейсе увеличились размеры текста, отступов и элементов управления. Если модальная форма была рассчитана под старые размеры и имеет фиксированную высоту или ширину, её содержимое может перестать помещаться.

Что проверить у модальной формы в первую очередь?

Проверить, заданы ли у формы фиксированные размеры через formSize.height и formSize.width, а также используется ли formSize.fixed. Если размеры заданы под старый интерфейс, их нужно пересмотреть.

Нужно ли менять фиксированную высоту и ширину, заданные под старый интерфейс?

Да, если содержимое формы перестало помещаться. В первую очередь нужно пересматривать фиксированную высоту, так как именно она чаще всего приводит к сжатию контента и кнопок.

Что делать, если перестали умещаться не отдельные окна, а интерфейс в целом?

Для массового сценария миграции можно рассмотреть Configuration.Client.Ui.density в режиме компактной плотности UI. По умолчанию рекомендуется оставаться на Configuration.Client.Ui.UiDensity.normal и переходить к compact только в том случае, если проблема с размещением элементов проявляется по всему прикладному проекту, а не в отдельных формах.

Когда достаточно включить Компактную плотность UI, а когда нужно править саму форму?

Компактную плотность UI имеет смысл использовать только тогда, когда проблема наблюдается массово по решению. Если проблема локальна и связана с конкретной модальной формой или несколькими отдельными окнами, предпочтительнее скорректировать размеры и компоновку самих форм, а не компенсировать это глобальным переключением плотности UI.

Стоит ли включать Компактную плотность UI по умолчанию при переходе?

Нет. По умолчанию рекомендуется оставаться на Configuration.Client.Ui.UiDensity.normal, а compact включать только при явных массовых проблемах с размещением элементов по всему прикладному проекту.

Какая минимальная версия сервера рекомендуется для сценария миграции?

Настройка плотности UI доступна с версии AS - 1.26.0-rc13, но для задач миграции рекомендуется использовать версию сервера не ниже 1.26.0-rc18, так как в ней уже учтены дополнительные улучшения по уплотнению интерфейса.