Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/shakurocom/draggableoverlay
https://github.com/shakurocom/draggableoverlay
component drag-and-drop draggable draggable-elements draggable-panel draggableview ios overlay swift uicomponent uikit xcode
Last synced: 29 days ago
JSON representation
- Host: GitHub
- URL: https://github.com/shakurocom/draggableoverlay
- Owner: shakurocom
- License: mit
- Created: 2022-03-15T09:10:35.000Z (almost 3 years ago)
- Default Branch: main
- Last Pushed: 2023-01-24T11:48:57.000Z (almost 2 years ago)
- Last Synced: 2024-11-18T05:33:35.825Z (about 1 month ago)
- Topics: component, drag-and-drop, draggable, draggable-elements, draggable-panel, draggableview, ios, overlay, swift, uicomponent, uikit, xcode
- Language: Swift
- Homepage:
- Size: 10.8 MB
- Stars: 20
- Watchers: 1
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
![Shakuro Draggable Overlay](Resources/title_image.png)
# DraggableOverlay
![Version](https://img.shields.io/badge/version-1.0.0-blue.svg)
![Platform](https://img.shields.io/badge/platform-iOS-lightgrey.svg)
![License MIT](https://img.shields.io/badge/license-MIT-green.svg)- [Requirements](#requirements)
- [Installation](#installation)
- [Usage](#usage)
- [License](#license)A `DraggableOverlay` is a Swift library - an overlay that dynamically reveals or hides the content inside it. It can be dragged up and down to stick to predefined anchors. Whenever a drag gesture ends, the overlay motion will continue until it reaches one of its anchors. `DraggableOverlay` has various configuration options.
`DraggableOverlay` example with default options:
![](Resources/draggable_overlay_example_1.gif)
`DraggableOverlay` example with enabled shadow (red color) and container shadow (green color), customized draggable container height (30 px):
![](Resources/draggable_overlay_example_2.gif)
`DraggableOverlay` example with custom handle corner and custom handle container corner radius, customized handle color (yellow) and changed top inset:
![](Resources/draggable_overlay_example_3.gif)
`DraggableOverlay` example with bounce animation:
![](Resources/draggable_overlay_example_4.gif)
## Requirements
- iOS 11.0+
- Xcode 11.0+
- Swift 5.0+## Installation
### CocoaPods
To integrate `DraggableOverlay` into your Xcode project with CocoaPods, specify it in your `Podfile`:
```ruby
pod 'Shakuro.DraggableOverlay'
```Then, run the following command:
```bash
$ pod install
```### Manually
If you prefer not to use CocoaPods, you can integrate Shakuro.DraggableOverlay simply by copying it to your project.
## Usage
Just initilize `DraggableDetailsOverlayViewController` with your nested viewcontroller and delegate. Nested viewcontroller must adopt the `DraggableDetailsOverlayViewControllerDelegate` and `DraggableDetailsOverlayNestedInterface` protocols. The delegate allows to respond to scrolling events.
Have a look at the [DraggableOverlayExample](https://github.com/shakurocom/DraggableOverlay/tree/main/DraggableOverlayExample) (perform `pod install` before usage)## License
Shakuro.DraggableOverlay is released under the MIT license. [See LICENSE](https://github.com/shakurocom/DraggableOverlay/blob/main/LICENSE.md) for details.
## Give it a try and reach us
Star this tool if you like it, it will help us grow and add new useful things.
Feel free to reach out and hire our team to develop a mobile or web project for you.