VBox

class View.Representation.Layout.FlexComposer.FlexLayout.VBox

Контейнер для использования в FlexLayout, внутри которого главная ось проходит в вертикальном направлении, а вложенные элементы растягиваются на всю ширину контейнера

Added in version AS: 1.24.0-ms12

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

elem hbox → View.Representation.Layout.FlexComposer.FlexLayout.HBox

Контейнер для использования в FlexLayout, внутри которого главная ось проходит в горизонтальном направлении, а вложенные элементы растягиваются на всю высоту контейнера

Added in version AS: 1.24.0-ms12

elem detail → View.Representation.Layout.FlexComposer.FlexLayout.Detail

Представление детального фрейма в FlexLayout

Added in version AS: 1.24.0-ms12

elem master → View.Representation.Layout.FlexComposer.FlexLayout.Master

Представление мастер-фрейма в FlexLayout

Added in version AS: 1.24.0-ms12

Атрибуты:

attr minSize → String

Минимальный размер элемента. Если элемент вложен в горизонтальный контейнер, то под размером подразумевается ширина, иначе - высота. Допускается использование пикселей (например, “300px”) и процентов (например, “30%”).

Работает как CSS min-width/min-height с одним отличием: нижняя граница размера фрейма 50px сильнее minSize, поэтому значение меньше 50px поднимается до 50px. Если элементы не помещаются в контейнер, например сумма минимумов больше контейнера, не поместившаяся часть обрезается: прокрутки у контейнера нет.

attr maxSize → String

Максимальный размер элемента. Если элемент вложен в горизонтальный контейнер, то под размером подразумевается ширина, иначе - высота. Допускается использование пикселей и процентов.

Работает как CSS max-width/max-height с отличиями:

  • нижняя граница размера фрейма 50px сильнее maxSize: maxSize="40px" даёт жёсткие 50px;

  • maxSize 0 (например, “0”, “0px”, “0%”) скрывает элемент: он не участвует в раскладке и не получает сплиттера;

  • элемент с maxSize не больше 50px или с minSize не меньше maxSize в той же единице считается жёстким: его размер не меняется.

attr flex → String

CSS-свойство flex. flex. Значение передаётся браузеру как есть, поэтому работают все формы CSS, включая calc() в базисе. Отличия от CSS:

  • по умолчанию “1” (в CSS 1 1 0%): так же считается атрибут пустой или из пробелов;

  • inherit берёт flex родительского hbox/vbox из метаданных; у элемента верхнего уровня flex равен “1”;

  • размер содержимого фрейма не измеряется, поэтому базис auto и его производные (none, 0 0 auto) считаются нулевыми: элемент без роста занимает свой минимальный размер;

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

Сплиттер заменяет базис из flex. Когда пользователь сдвигает сплиттер, текущие размеры всех элементов контейнера, а не только двух соседних, сохраняются в пикселях и подставляются вместо базиса. Веса роста и сжатия остаются и действуют при изменении размера окна, minSize и maxSize сильнее сохранённого размера. Размер сохраняется для пользователя и разрешения экрана, метаданные не меняются. Поэтому базис задаёт раскладку только до первого сдвига сплиттера, а то, что должно выполняться всегда, задаётся через minSize и maxSize.

Сплиттер встаёт точно в точку отпускания, только когда элементы занимают контейнер целиком: иначе браузер заново делит остаток места, и граница смещается. Чтобы контейнер был заполнен при любом размере окна, хотя бы у одного его элемента вес роста должен быть не меньше 1, а maxSize не задан. Проще всего оставить одному элементу flex по умолчанию. Контейнера, в котором все элементы жёсткие, это не касается: сплиттеры в нём неподвижны. Элементы с нулевым весом сжатия должны в сумме помещаться в контейнер: иначе не поместившаяся часть обрезается, а сплиттер рядом с ними тоже встаёт неточно.