DynamicComposer
===============

.. toctree::
   :hidden:
   :titlesonly:

   dynamiccomposer/DynamicItems.rst

.. xsd:class:: View.Representation.Layout.DynamicComposer

   Компоновщик позволяет определить размещение фреймов, связанных отношением мастер-деталь, относительно друг друга.
   
   
   
   Содержит:
   
   
   * один мастер-фрейм, представление которого описывается внутри вложенного элемента :java:ref:`Frame`.
     Его выравнивание задаётся в :java:ref:`DynamicItems.masterAlign`.
     Если оно не указано явно, оно автоматически становится :java:ref:`Aligns.Client`
   * [0..N] детальных фреймов, определённых в коллекции :java:ref:`DynamicItems`
   
   
   
   
   
   Фреймы мастера и деталей располагаются в порядке их перечисления в разметке в соответствии с их выравниванием по
   границе свободного пространства или :java:ref:`Aligns.Client`-области.
   
   
   Первым фреймом в перечислении неявно является мастер-фрейм.
   
   
   Например, фрейм с выравниванием :java:ref:`Aligns.Top` займёт всё место вдоль
   верхней границы. Если за ним следует ещё один фрейм с выравниванием :java:ref:`Aligns.Top`,
   то он займёт верхнюю границу свободного пространства (ниже предыдущего). Следующие по порядку фреймы будут добавляться
   к свободной области по тому же принципу. Фрейм с выравниванием :java:ref:`Aligns.Client`
   занимает оставшееся свободное место после расположения всех фреймов, выравнивание которых не равно
   :java:ref:`Aligns.Client`.
   
   
   Важно: можно указать не более одного фрейма с выравниванием 'client'.
   
   
   
   
   .. versionadded:: AS 1.23.0-ms5 Добавлено упорядоченное чтение коллекции детальных фреймов. В зависимости от указанного порядка меняется взаимное расположение фреймов
   
   .. seealso::
      `Примеры <https://docs.global-system.ru/as/dev/spec/ui-components/composer/dynamic_composer.html>`_

.. xsd:class::

   :Вложенные элементы:

   .. xsd:element:: frame: View.Representation.Layout.Frame


      Фрейм.
      
      
      
      Базовый элемент интерфейса пользователя, отображающий данные выборки.
      
      
      
      Вложенный элемент: <grid/>,<tree/>,<card/> и т.д. - определяет способ представления данных выборки
      в рабочей области фрейма.

   .. xsd:element:: dynamicItems: View.Representation.Layout.DynamicComposer.DynamicItems


      Упорядоченная коллекция статических детальных выборок.
      Свойства каждой детали как части фрейма-компоновщика описываются внутри элемента :java:ref:`DynamicItem`