Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/batanus/DMScrollBar
Interactive and customizable scroll bar with deceleration and appearing info label during scrolling for Scroll View
https://github.com/batanus/DMScrollBar
cocoapods collectionview ios scroll scroll-bar scroll-indicator scroll-view scrollbar scrollindicator scrollview scrollview-component swift tableview uicollectionview uiscrollview uitableview
Last synced: 6 days ago
JSON representation
Interactive and customizable scroll bar with deceleration and appearing info label during scrolling for Scroll View
- Host: GitHub
- URL: https://github.com/batanus/DMScrollBar
- Owner: batanus
- License: mit
- Created: 2022-12-26T15:45:04.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2023-11-17T19:17:25.000Z (12 months ago)
- Last Synced: 2024-10-02T00:36:48.378Z (about 1 month ago)
- Topics: cocoapods, collectionview, ios, scroll, scroll-bar, scroll-indicator, scroll-view, scrollbar, scrollindicator, scrollview, scrollview-component, swift, tableview, uicollectionview, uiscrollview, uitableview
- Language: Swift
- Homepage:
- Size: 202 KB
- Stars: 32
- Watchers: 1
- Forks: 5
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- fucking-awesome-swift - DMScrollBar - Best in class customizable ScrollBar for any type of ScrollView with Decelerating, Bounce & Rubber band mechanisms and many many more. (Libs / UI)
- awesome-swift - DMScrollBar - Best in class customizable ScrollBar for any type of ScrollView with Decelerating, Bounce & Rubber band mechanisms and many many more. (Libs / UI)
README
# DMScrollBar
[](https://travis-ci.org/batanus/DMScrollBar)
[](https://cocoapods.org/pods/DMScrollBar)
[](https://cocoapods.org/pods/DMScrollBar)
[](https://cocoapods.org/pods/DMScrollBar)
## Example
iOS style | Default style | iOS & Default combined style | Absolutely custom style | Right label style |Easy to change
:-: | :-: | :-: | :-: | :-: | :-:
| 
| 
| 
| 
| 
| 
## Description
DMScrollBar is best in class customizable ScrollBar for ScrollView. It has:
- Showing info label when user interaction with ScrollBar is started
- Decelerating, Bounce & Rubber band mechanisms
- Super customizable configuration
- Different states for active / inactive states
- Haptic feedback on interaction start / end and when info label changes on specified offset
- Super Fancy animations
## Installation
DMScrollBar is available through [CocoaPods](https://cocoapods.org). To install
it, simply add the following line to your Podfile:
```ruby
pod 'DMScrollBar', '~> 1.0.0'
```
and run
```ruby
pod install
```
## Usage
On any ScrollView you want to add the ScrollBar with default configuration, just call (see result on Gid #2):
```swift
scrollView.configureScrollBar()
```
If you want to provide title for info label, implement `DMScrollBarDelegate` protocol on your ViewController:
```swift
extension ViewController: DMScrollBarDelegate {
/// In this example, this method returns the section header title for the top visible section
func indicatorTitle(forOffset offset: CGFloat) -> String? {
return "Your title for info label"
}
}
```
If you want to have iOS style scroll bar, configure ScrollBar with `.iosStyle` config (_Next code will create config for the Scroll Bar for Gif #1_):
```swift
scrollView.configureScrollBar(with: .iosStyle, delegate: self)
```
Any ScrollBar configuration can be easily combined with another one (_Next code will create config for the Scroll Bar for Gif #3_):
```swift
let iosCombinedDefaultConfig = DMScrollBar.Configuration(
indicator: .init(
normalState: .iosStyle(width: 3),
activeState: .default
)
)
scrollView.configureScrollBar(with: iosCombinedDefaultConfig, delegate: self)
```
If you want to configure scroll bar, with custom config, create configuration and call `configureScrollBar` (_Next code will create config for the Scroll Bar for Gif #4_):
```swift
let customConfig = DMScrollBar.Configuration(
isAlwaysVisible: false,
hideTimeInterval: 1.5,
shouldDecelerate: false,
indicator: DMScrollBar.Configuration.Indicator(
normalState: .init(
size: CGSize(width: 35, height: 35),
backgroundColor: UIColor(red: 200 / 255, green: 150 / 255, blue: 80 / 255, alpha: 1),
insets: UIEdgeInsets(top: 8, left: 0, bottom: 8, right: 0),
image: UIImage(systemName: "arrow.up.and.down.circle")?.withRenderingMode(.alwaysOriginal).withTintColor(UIColor.white),
imageSize: CGSize(width: 20, height: 20),
roundedCorners: .roundedLeftCorners
),
activeState: .custom(
config: .init(
size: CGSize(width: 50, height: 50),
backgroundColor: UIColor.brown,
insets: UIEdgeInsets(top: 8, left: 0, bottom: 8, right: 6),
image: UIImage(systemName: "calendar.circle")?.withRenderingMode(.alwaysOriginal).withTintColor(UIColor.cyan),
imageSize: CGSize(width: 28, height: 28),
roundedCorners: .allRounded
),
textConfig: nil
),
stateChangeAnimationDuration: 0.5,
insetsFollowsSafeArea: true,
animation: .init(showDuration: 0.75, hideDuration: 0.75, animationType: .fadeAndSide)
),
infoLabel: DMScrollBar.Configuration.InfoLabel(
font: .systemFont(ofSize: 15),
textColor: .white,
distanceToScrollIndicator: 40,
backgroundColor: .brown,
textInsets: UIEdgeInsets(top: 8, left: 8, bottom: 8, right: 8),
maximumWidth: 300,
roundedCorners: .init(radius: .rounded, corners: [.topLeft, .bottomRight]),
animation: .init(showDuration: 0.75, hideDuration: 0.75, animationType: .fadeAndSide)
)
)
scrollView.configureScrollBar(with: customConfig, delegate: self)
```
## Author
Dmitrii Medvedev, [email protected]
## License
DMScrollBar is available under the MIT license. See the LICENSE file for more info.