WrappingHStack

УпаковкаHStack

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

Пример

 WrappingHStack {
    Text ( " WrappingHStack " )
        . padding ( )
        . font ( . title )
        . border ( Color . black )
    
    Text ( " can handle different element types " )
    
    Image ( systemName : " scribble " )
        . font ( . title )
        . frame ( width : 200 , height : 20 )
        . background ( Color . purple )
    
    Text ( " and loop " )
        . bold ( )
    
    WrappingHStack ( 1 ... 20 , id :  . self ) {
        Text ( " Item: ( $0 ) " )
            . padding ( 3 )
            . background ( Rectangle ( ) . stroke ( ) )
    } . frame ( minWidth : 250 )
}
. padding ( )
. border ( Color . black ) 

Установка

Требования iOS 13+

Менеджер пакетов Swift

1. В Xcode откройте свой проект и перейдите в «Файл» → «Пакеты Swift» → «Добавить зависимость пакета».
2. Вставьте URL-адрес репозитория (https://github.com/dkk/WrappingHStack) и нажмите «Далее».
3. В разделе «Правила» выберите версию.
4. Нажмите «Готово».

Свифт-пакет

 . package ( url : " https://github.com/dkk/WrappingHStack " , . upToNextMajor ( from : " 2.0.0 " ) )

Какао-стручки

Просто добавьте следующую строку в свой Podfile :

 pod 'WrappingHStack' 

Использование

Импортируйте пакет WrappingHStack в свое представление:

import WrappingHStack

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

 WrappingHStack {
    /* some views */
    NewLine ( ) // Optional: Use NewLine to force the next element to be placed in a next line
    /* some more views */
}

или как ForEach для перебора элементов:

 WrappingHStack ( 1 ... 30 , id :  . self ) {
    Text ( " Item: ( $0 ) " )
}

Позиционирование товара

Вы управляете положением элементов с помощью параметра alignment , который задает HorizontalAlignment элементов. Т.е. ведущий, конечный или центрированный.

Для еще большего удобства и гибкости WrappingHSTack предлагает параметр spacing , который определяет, как будет рассчитываться интервал. Это может быть один из следующих типов:

• .constant : для фиксированного интервала каждая строка начинается с элемента, а горизонтальное разделение между любыми двумя элементами равно заданному значению.
• .dynamic : чтобы элементы заполняли ширину WrappingHSTack. Вы можете передать минимальный интервал.
• .dynamicIncludingBorders , чтобы заполнить всю ширину с равным интервалом между элементами и от элементов до границы. Вы можете передать минимальный интервал.

Известные проблемы

• Проблема № 15. Размеры элементов рассчитываются неправильно, если в WrappingHStack есть модификаторы, изменяющие размер элементов.
• Проблема № 16: необходимо обходное решение при использовании WrappingHStack в NavigationLink (только для iOS16).
• Проблема № 10: SPM не может разрешить зависимость (только Xcode 11.3.1).

Способствовать

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

Поддерживать

Спонсорьте этот проект, чтобы получить вознаграждение и моральную поддержку.

Лицензия

WrappingHStack был первоначально разработан Дэниелом Клёком и выпущен под лицензией MIT.