Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
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: 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 (about 4 years ago)
- Default Branch: main
- Last Pushed: 2024-01-31T16:12:02.000Z (12 months ago)
- Last Synced: 2024-08-03T18:12:00.498Z (6 months ago)
- Topics: carousel, image, image-scroll, ios, scroll, swift, swift5, swiftui
- Language: Swift
- Homepage:
- Size: 15.8 MB
- Stars: 385
- Watchers: 6
- Forks: 81
- 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)
   
## 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