WrappingHStack

HStackのラッピング

WrappingHStack は HStack と非常によく似た方法で動作する UI 要素ですが、オーバーフローした要素を自動的に次の行に配置します。

例

 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 : 固定間隔の場合、各行は項目で始まり、任意の 2 つの項目間の水平方向の間隔は指定された値になります。
• .dynamic : 項目が WrappingHSTack の幅を満たすようにします。最小限の間隔で通過できます。
• .dynamicIncludingBorders使用して、項目間および項目から境界線までの等間隔で全幅を埋めます。最小限の間隔で通過できます。

既知の問題

• 問題 #15: WrappingHStack に要素のサイズを変更する修飾子がある場合、項目のサイズが正しく計算されません。
• 問題 #16: NavigationLinkでWrappingHStack使用する場合は回避策が必要です (iOS16 のみ)。
• 問題 #10: SPM は依存関係を解決できません (Xcode 11.3.1 のみ)。

貢献する

報告された問題や機能リクエストの解決に協力し、プル リクエストを作成することで、このプロジェクトに貢献できます。

サポート

このプロジェクトをスポンサーして報酬を獲得し、私の精神力を高めてください。

ライセンス

WrappingHStack はもともと Daniel Klöck によって開発され、MIT ライセンスの下でリリースされました。