WrappingHStack Télécharger - WrappingHStack Téléchargement du code source

WrappingHStack

Autre code source

2.2.11

Télécharger

EmballageHStack

WrappingHStack est un élément d'interface utilisateur qui fonctionne de manière très similaire à HStack, mais positionne automatiquement les éléments débordants sur les lignes suivantes.

Exemple

 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 )

Installation

Exigences iOS 13+

Gestionnaire de paquets Swift

Dans Xcode, ouvrez votre projet et accédez à Fichier → Packages Swift → Ajouter une dépendance de package.
Collez l'URL du référentiel (https://github.com/dkk/WrappingHStack) et cliquez sur Suivant.
Pour Règles, sélectionnez la version.
Cliquez sur Terminer.

Forfait Swift

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

Cocoapods

Ajoutez simplement la ligne suivante à votre Podfile :

 pod 'WrappingHStack'

Usage

Importez le package WrappingHStack dans votre vue :

import WrappingHStack

utilisez-le comme vous utiliseriez HStack pour des éléments uniques :

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

ou comme un ForEach pour parcourir les éléments :

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

Positionnement de l'article

Vous contrôlez la position des éléments à l'aide du paramètre alignment , qui définit l' HorizontalAlignment des éléments. C'est-à-dire en tête, en queue ou centré.

Pour encore plus de commodité et de flexibilité, WrappingHSTack propose le paramètre spacing , qui définit la manière dont l'espacement sera calculé. Il peut s'agir de l'un des types suivants :

.constant : pour un espacement fixe, chaque ligne commence par un élément et la séparation horizontale entre 2 éléments quelconques est la valeur donnée.
.dynamic : pour que les éléments remplissent la largeur du WrappingHSTack. Vous pouvez passer un espacement minimal.
.dynamicIncludingBorders pour remplir toute la largeur avec un espacement égal entre les éléments et entre les éléments et la bordure. Vous pouvez passer un espacement minimal.

Problèmes connus

Problème n°15 : Les tailles des éléments sont calculées de manière incorrecte lorsque WrappingHStack comporte des modificateurs qui modifient la taille de ses éléments.
Problème n°16 : Solution de contournement nécessaire lors de l'utilisation WrappingHStack dans un NavigationLink (iOS16 uniquement).
Problème n°10 : SPM ne peut pas résoudre la dépendance (Xcode 11.3.1 uniquement).