Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/alekseypleshkov/uisliderview
Easy and customizable Swift image slider with lazy loading images and full screen viewer
https://github.com/alekseypleshkov/uisliderview
Last synced: 8 days ago
JSON representation
Easy and customizable Swift image slider with lazy loading images and full screen viewer
- Host: GitHub
- URL: https://github.com/alekseypleshkov/uisliderview
- Owner: AlekseyPleshkov
- License: mit
- Created: 2020-01-30T10:33:27.000Z (almost 5 years ago)
- Default Branch: master
- Last Pushed: 2022-08-10T18:40:21.000Z (over 2 years ago)
- Last Synced: 2024-10-31T15:43:33.097Z (14 days ago)
- Language: Swift
- Size: 12.7 MB
- Stars: 3
- Watchers: 2
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# đĻ UISliderView
Easy and customizable Swift image slider with lazy loading images and full screen viewer
## đ Installation
#### CocoaPods
[CocoaPods](https://cocoapods.org) is a dependency manager for Cocoa projects. You can install it with the following command:
```bash
$ gem install cocoapods
```
For integrate `UISliderView` into your Xcode project using CocoaPods, specify it in your `Podfile`:
```ruby
source 'https://github.com/CocoaPods/Specs.git'
platform :ios, '11.0'
use_frameworks!
target '' do
pod 'UISliderView', '~> 1.0.6'
end
```
Then, run the following terminal command in project directory:
```bash
$ pod install
```
#### Swift Package Manager
For use [The Swift Package Manager](https://swift.org/package-manager/) you need add `UISliderView` dependency to `Package.swift` file:
```swift
import PackageDescription
let package = Package(
name: "PROJECT_NAME",
targets: [],
dependencies: [
.package(url: "https://github.com/AlekseyPleshkov/UISliderView.git", from: "1.0.6")
]
)
```
Then add `UISliderView` to your targets dependencies:
```swift
.target(
name: "TARGET_NAME",
dependencies: [
"UISliderView",
]
),
```
And run terminal command:
```bash
swift package update
```
Or use SPM in XCode đ
## đģ How to use
### Simple usage
Import package in your file
```
import UISliderView
```
Set `UISliderView` class to custom class for empty view or create `UISliderView` class programmably.
```swift
@IBOutlet weak var sliderView: UISliderView!
// or
let sliderView = UISliderView()
```
Set list of image urls to `sliderView` and run `reloadData()` method for create/reload slides with images
```swift
sliderView.images = [
URL(string: "https://source.unsplash.com/1024x1024")!,
URL(string: "https://source.unsplash.com/1024x1024")!,
URL(string: "https://source.unsplash.com/1024x1024")!,
URL(string: "https://source.unsplash.com/1024x1024")!
]
sliderView.reloadData()
```
It's done!
### Available configurations
- `delegate: UISliderViewDelegate?`. The object that acts as the delegate of the slider view. Notifies at main events.
- `viewController: UIViewController?`. View controller for show full screen slider. Set this parameter to open slider in full screen.
- `images: [URL]`. List of image urls for loading and showing in sliders.
- `imageContentMode: UIView.ContentMode = .scaleAspectFill`. Image content mode for slide.
- `activityIndicatorColor: UIColor = .black`. Activity indicator color (while the image is loading).
- `activityIndicatorStyle: UIActivityIndicatorView.Style?`. /// Activity indicator style (while the image is loading).
- `pageIndicatorColor: UIColor?`. Page indicator color.
- `pageCurrentIndicatorColor: UIColor?`. Current page indicator color.
- `fullScreenImageContentMode: UIView.ContentMode = .scaleAspectFill`. Image content mode for full screen slide.
- `fullScreenActivityIndicatorColor: UIColor = .white`. Activity indicator color (while the image is loading) for full screen slide.
- `fullScreenActivityIndicatorStyle: UIActivityIndicatorView.Style?`. /// Activity indicator style (while the image is loading) for full screen slide.
- `fullScreenBackButtonImage: UIImage?`. Image for back button in full screen mode. Automatically hidden button if image not set.
- `isShowPageControl: Bool = true`. Shows pageControl indicator.
### Methods
- `reloadData()`. Reloads slides by list of url images. Call this method after set list of urls to image parameter.
### Delegate
- `sliderView(_ sliderView: UISliderView, didChangeSlideAt index: Int)`. Tells the delegate that the slide did change.
- `sliderView(_ sliderView: UISliderView, didChangeFullScreenVisible isVisible: Bool)`. Tells the delegate that the full screen view did change visible state.
## đ§ Requirements
- Swift 5.0
- XCode 10
- iOS 11 or later
## đ About Me
* Aleksey Pleshkov
* Email: [[email protected]](mailto:[email protected])
* Website: [alekseypleshkov.ru](https://alekseypleshkov.ru)
## Šī¸ License
`UISliderView` is released under the MIT license. In short, it's royalty-free but you must keep the copyright notice in your code or software distribution.