WrappingHStack

WrappingHStack

WrappingHStack é um elemento de UI que funciona de maneira muito semelhante ao HStack, mas posiciona automaticamente os elementos transbordantes nas próximas linhas.

Exemplo

 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 ) 

Instalação

Requisitos iOS 13+

Gerenciador de pacotes Swift

1. No Xcode, abra seu projeto e navegue até Arquivo → Pacotes Swift → Adicionar Dependência de Pacote.
2. Cole o URL do repositório (https://github.com/dkk/WrappingHStack) e clique em Avançar.
3. Para Regras, selecione a versão.
4. Clique em Concluir.

Pacote Swift

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

Cocoápodes

Basta adicionar a seguinte linha ao seu Podfile :

 pod 'WrappingHStack' 

Uso

Importe o pacote WrappingHStack para sua visualização:

import WrappingHStack

use-o como usaria o HStack para elementos únicos:

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

ou como um ForEach para fazer um loop nos itens:

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

Posicionamento de itens

Você controla a posição dos itens usando o parâmetro alignment , que define o HorizontalAlignment dos itens. Ou seja, à frente, atrás ou centralizado.

Para ainda mais comodidade e flexibilidade, WrappingHSTack oferece o parâmetro spacing , que define como o espaçamento será calculado. Pode ser um dos seguintes tipos:

• .constant : para espaçamento fixo, cada linha começa com um item e a separação horizontal entre quaisquer 2 itens é o valor fornecido.
• .dynamic : para que os itens preencham a largura do WrappingHSTack. Você pode passar um espaçamento mínimo.
• .dynamicIncludingBorders para preencher toda a largura com espaçamento igual entre os itens e dos itens até a borda. Você pode passar um espaçamento mínimo.

Problemas conhecidos

• Problema nº 15: os tamanhos dos itens são calculados incorretamente quando WrappingHStack possui modificadores que alteram o tamanho de seus elementos.
• Problema nº 16: solução alternativa necessária ao usar WrappingHStack em um NavigationLink (somente iOS16).
• Problema nº 10: o SPM não pode resolver a dependência (somente Xcode 11.3.1).

Contribuir

Você pode contribuir com este projeto ajudando-me a resolver quaisquer problemas relatados ou solicitações de recursos e criando uma solicitação pull.

Apoiar

Patrocine este projeto para receber uma recompensa e me dar um impulso moral.

Licença

WrappingHStack foi originalmente desenvolvido por Daniel Klöck e é lançado sob a licença MIT.