https://github.com/JWAutumn/ACarousel

A carousel view for SwiftUI | SwiftUI 旋转木马效果
https://github.com/JWAutumn/ACarousel

carousel image image-scroll ios scroll swift swift5 swiftui

Last synced: about 2 months ago
JSON representation

A carousel view for SwiftUI | SwiftUI 旋转木马效果

• Host: GitHub
• URL: https://github.com/JWAutumn/ACarousel
• Owner: JWAutumn
• License: mit
• Created: 2020-11-15T14:32:03.000Z (almost 4 years ago)
• Default Branch: main
• Last Pushed: 2024-01-31T16:12:02.000Z (8 months ago)
• Last Synced: 2024-07-06T04:13:05.142Z (3 months ago)
• Topics: carousel, image, image-scroll, ios, scroll, swift, swift5, swiftui
• Language: Swift
• Homepage:
• Size: 15.8 MB
• Stars: 381
• Watchers: 6
• Forks: 78
• Open Issues: 28
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-swiftui-libraries - ACarousel - A carousel view for SwiftUI (Carousel / Content)

README

        
# ACarousel

A carousel view for SwiftUI

[中文文档](README.zh-CN.md)















&nbsp&nbsp&nbsp





## Table of Contents

  - [Requirements](#requirements)

  - [Install](#install)

  - [Usage](#usage)

  - [Example](#example)

  - [Maintainers](#maintainers)

  - [Contributing](#contributing)

  - [License](#license)

## Requirements

- iOS 13.0+ / macOS 10.15+ / tvOS 13.0+

- Xcode 11.0+

- Swift 5.1+

## Install

### Swift Package Manager

Open `Xcode`, go to `File -> Swift Packages -> Add Package Dependency` and enter `https://github.com/JWAutumn/ACarousel`

You can also add `ACarousel` as a dependency to your `Package.swift`:

```swift

dependencies: [

  .package(url: "https://github.com/JWAutumn/ACarousel", from: "0.2.0")

]

```

### Manually

[Download](https://github.com/JWAutumn/ACarousel/archive/main.zip) and open the project, drag the `ACarousel.swift` file into your own project.

## Usage

- Basic use: The parameters of `ACarousel` have default values, so you can simply pass in the data source and eat it ~

```swift

struct Item: Identifiable {

    let id = UUID()

    let image: Image

}

let roles = ["Luffy", "Zoro", "Sanji", "Nami", "Usopp", "Chopper", "Robin", "Franky", "Brook"]

struct ContentView: View {

    

    let items: [Item] = roles.map { Item(image: Image($0)) }

    

    var body: some View {

        ACarousel(items) { item in

            item.image

                .resizable()

                .scaledToFill()

                .frame(height: 300)

                .cornerRadius(30)

        }

        .frame(height: 300)

    }

}

```

or:

```swift

...

var body: some View {

    ACarousel(roles, id: \.self) { name in

        Image(name)

            .resizable()

            .scaledToFill()

            .frame(height: 300)

            .cornerRadius(30)

    }

    .frame(height: 300)

}

...

```

- Customize configuration: You can configure the corresponding parameters to customize the display style according to your needs.

```swift

 /// ...

struct ContentView: View {

    

    let items: [Item] = roles.map { Item(image: Image($0)) }

    

    var body: some View {

        ACarousel(items,

                  spacing: 10,

                  headspace: 10,

                  sidesScaling: 0.7,

                  isWrap: true,

                  autoScroll: .active(2)) { item in

            item.image

                .resizable()

                .scaledToFill()

                .frame(height: 300)

                .cornerRadius(30)

        }

        .frame(height: 300)

    }

}

```

## Example

[Download](https://github.com/JWAutumn/ACarousel/archive/main.zip) and open `ACarouselDemo -> ACarouselDemo.xcodeproj`, run and view.

## Maintainers

[@JWAutumn](https://github.com/JWAutumn)，[@Underthestars-zhy](https://github.com/underthestars-zhy)， [@Alexander Chapliuk](https://github.com/krin-san)，[@thitran-incepit](https://github.com/thitran-incepit).

## Contributing

Feel free to dive in! [Open an issue](https://github.com/JWAutumn/ACarousel/issues/new) or submit PRs.

## License

[MIT](LICENSE) © JWAutumn