ScrollKit

Sobre ScrollKit

O ScrollKit é um SDK Swifttu que adiciona poderosos recursos de rolagem, como rastreamento deslocado e uma visão de cabeçalho que se estende e se transforma enquanto você puxa para baixo e gruda na parte superior quando você rola.

O ScrollKit funciona em todas as principais plataformas da Apple e foi projetado para ser fácil de usar. Atualmente, não usa as novas APIs ScrollView por motivos de compatibilidade do SO, mas acabará o fará.

Instalação

ScrollKit pode ser instalado com o Swift Package Manager:

 https://github.com/danielsaidi/ScrollKit.git

Começando

ScrollKit tem uma visualização ScrollViewWithOffsetTracking que pode detectar rolagem:

 ScrollViewWithOffsetTracking { offset in
    print ( offset )
} content : {
    // Add your scroll content here, e.g. a `LazyVStack`
}

O ScrollKit também possui um ScrollViewWithStickyHeader que facilita a configuração de um cabeçalho elástico e pegajoso:

 struct MyView : View {

    @ State
    private var offset = CGPoint . zero
    
    @ State
    private var visibleRatio = CGFloat . zero
    
    func handleOffset ( _ scrollOffset : CGPoint , visibleHeaderRatio : CGFloat ) {
        self . offset = scrollOffset
        self . visibleRatio = visibleHeaderRatio
    }
    
    func header ( ) -> some View {
        ZStack ( alignment : . bottomLeading ) {
            Color . blue
            Color . yellow . opacity ( visibleRatio )  // Fades in
        }
    }

    var body : some View {
        ScrollViewWithStickyHeader (
            header : header ,
            headerHeight : 250 ,
            headerMinHeight : 150 ,
            onScroll : handleOffset
        ) {
            // Add your scroll content here, e.g. a `LazyVStack`
        }
    }
}

Para mais informações, consulte o Guia de Iniciação.

Documentação

A documentação on -line tem mais informações, artigos, exemplos de código, etc.

Aplicação de demonstração

O aplicativo de demonstração permite explorar a biblioteca. Para experimentar, basta abrir e executar o projeto Demo .

Apoie meu trabalho

Você pode me patrocinar em patrocinadores do GitHub ou procurar apoio pago, para ajudar a apoiar meus projetos de código aberto.

Seu apoio permite que eu faça mais trabalho nesses projetos e os torne o melhor que podem ser.

Contato

Sinta -se à vontade para alcançar se tiver dúvidas ou quiser contribuir de alguma forma:

• Site: Danielsaidi.com
• Mastodon: @danielsaidi @mastodon.social
• Twitter: @danielsaidi
• E-mail: [email protected]

Licença

ScrollKit está disponível sob a licença do MIT. Consulte o arquivo de licença para obter mais informações.