.. _new_interface_migration:

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

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

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

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

.. _new_interface_migration_modal_forms:

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

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

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

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

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

1. Проверить, используются ли у формы свойства размера
   :xsd:attr:`formSize.fixed<View.Representation.formSize.fixed>`,
   :xsd:attr:`formSize.height<View.Representation.formSize.height>` и
   :xsd:attr:`formSize.width<View.Representation.formSize.width>`.
2. Если размеры были подобраны под старый интерфейс, пересмотреть их под текущую плотность UI.
3. В первую очередь проверить фиксированную высоту, так как именно она чаще всего приводит к сжатию контента и кнопок.
4. Если жёсткая фиксация размера не обязательна, отдельно оценить необходимость использования
   :xsd:attr:`formSize.fixed<View.Representation.formSize.fixed>`.

.. seealso::

   * :xsd:attr:`formSize.fixed<View.Representation.formSize.fixed>`
   * :xsd:attr:`formSize.height<View.Representation.formSize.height>`
   * :xsd:attr:`formSize.width<View.Representation.formSize.width>`

.. _new_interface_migration_ui_density:

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

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

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

.. note::

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

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

.. seealso::

   * :xsd:attr:`Configuration.Client.Ui.density`
   * :ref:`Плотность UI <spec_ui-density>`

.. _new_interface_migration_faq:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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