Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/fermoya/SwiftUIPager
Native Pager in SwiftUI
https://github.com/fermoya/SwiftUIPager
cocoapods ios macos pager pagerview swift5 swiftpackagemanager swiftui swiftui-components tvos watchos xcframework
Last synced: 26 days ago
JSON representation
Native Pager in SwiftUI
- Host: GitHub
- URL: https://github.com/fermoya/SwiftUIPager
- Owner: fermoya
- License: mit
- Created: 2020-01-20T16:07:49.000Z (almost 5 years ago)
- Default Branch: main
- Last Pushed: 2024-02-16T07:20:16.000Z (10 months ago)
- Last Synced: 2024-11-05T04:03:24.108Z (about 1 month ago)
- Topics: cocoapods, ios, macos, pager, pagerview, swift5, swiftpackagemanager, swiftui, swiftui-components, tvos, watchos, xcframework
- Language: Swift
- Homepage:
- Size: 38.1 MB
- Stars: 1,293
- Watchers: 13
- Forks: 171
- Open Issues: 42
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
- awesome-swiftui-libraries - SwiftUIPager - Native Pager in SwiftUI (Pages / Content)
- awesome - SwiftUIPager - Native Pager in SwiftUI (xcframework)
- awesome - SwiftUIPager - Native Pager in SwiftUI (swiftpackagemanager)
README
# SwiftUIPager
[](https://codecov.io/gh/fermoya/SwiftUIPager)
[](https://github.com/apple/swift-package-manager)
[](https://cocoapods.org/pods/SwiftUIPager)
[](https://github.com/Carthage/Carthage)
[](https://cocoapods.org/pods/SwiftUIPager)
[](https://opensource.org/licenses/MIT)
_SwiftUIPager_ provides a `Pager` component built with SwiftUI native components. `Pager` is a view that renders a scrollable container to display a handful of pages. These pages are recycled on scroll, so you don't have to worry about memory issues. `Pager` will load just a handful of items, enough to beatifully scroll along.
Create vertical or horizontal pagers, align the cards, change the direction of the scroll, animate the pagination... `Pager` lets you do anything you want.
- [Requirements](#requirements)
- [Installation](#installation)
- [Cocoapods](#cocoapods)
- [Swift Package Manager](#swift-package-manager)
- [Carthage](#carthage)
- [Manually](#manually)
- [Legacy projects support](Documentation/Legacy.md)
- [Usage](Documentation/Usage.md)
- [Initialization](Documentation/Usage.md#initialization)
- [UI customization](Documentation/Usage.md#ui-customization)
- [Configure your page size](Documentation/Usage.md#configure-your-page-size)
- [Pagination sensitivity](Documentation/Usage.md#pagination-sensitivity)
- [Orientation and direction](Documentation/Usage.md#orientation-and-direction)
- [Constrain direction](Documentation/Usage.md#constrain-direction)
- [Alignment](Documentation/Usage.md#alignment)
- [Partial pagination](Documentation/Usage.md#partial-pagination)
- [Multiple pagination](Documentation/Usage.md#multiple-pagination)
- [More modifiers](Documentation/Usage.md#more-modifiers)
- [Paging Priority](Documentation/Usage.md#paging-priority)
- [Animations](Documentation/Usage.md#animations)
- [Scale](Documentation/Usage.md#scale)
- [Rotation](Documentation/Usage.md#rotation)
- [Opacity](Documentation/Usage.md#opacity)
- [Loop](Documentation/Usage.md#loop)
- [Page Transitions](Documentation/Usage.md#page-transitions)
- [Add pages on demand](Documentation/Usage.md#add-pages-on-demand)
- [Content Loading Policy](Documentation/Usage.md#content-loading-policy)
- [Examples](Documentation/Usage.md#examples)
- [Known Issues](#known-issues)
- [Feedback](#feedback)
- [Support Open Source](#support-open-source)
- [License](#license)
## Requirements
* iOS 13.0+
* macOS 10.15+
* watchOS 6.0+
* tvOS 13.0+
* Swift 5.1+
## Installation
### CocoaPods
```ruby
pod 'SwiftUIPager'
```
### Swift Package Manager
In Xcode:
* File ⭢ Swift Packages ⭢ Add Package Dependency...
* Use the URL https://github.com/fermoya/SwiftUIPager.git
### Carthage
```swift
github "fermoya/SwiftUIPager"
```
### Manually
* Download _[SwiftUIPager.xcframework](SwiftUIPager.xcframework)_
* Create a group _Frameworks_ inside your project and drag and drop _SwiftUIPager.xcframework_
* Make sure in your target's build phases that the option _Embed & Sign_ is selected:
## Known Issues
* `NavigationLink` and `Button` might work oddly with `Pager` if `pagingPriority(.simultaneous)` is used in _SwiftUI 1.0_ and _iOS 13_. This issue isn't reproducible in _iOS 14 beta_. For more information, follow this [link](https://stackoverflow.com/questions/58440469/swiftui-navigationlink-and-scrollview-drag-gesture-colliding).
* Depending on the _Xcode_ version, you might run into a precondition failure affecting _SwiftUI 1.0_ and _iOS 13_. This issue doesn't occur on _Xcode 12 beta_. For more information about workarounds, see _Precondition failure: invalid value type for attribute [#60](https://github.com/fermoya/SwiftUIPager/issues/60)_.
## Feedback
If you happen to encounter any problem or you have any suggestion, please, don't hesitate to open an issue or reach out to me at [[email protected]](mailto:[email protected]).
This is an open source code project, so feel free to collaborate by raising a pull-request or sharing your feedback.
## Support Open Source
If you love this library, understand all the effort it takes to maintain it and would like to support me, you can buy me a coffee by following this [link](https://www.buymeacoffee.com/fermoya):
You can also sponsor me by hitting the [_GitHub Sponsor_](https://github.com/sponsors/fermoya) button. All help is very much appreciated.
## License
`SwiftUIPager` is available under the MIT license. See the [LICENSE](/LICENSE) file for more info.