Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/shakurocom/draggableoverlay

component drag-and-drop draggable draggable-elements draggable-panel draggableview ios overlay swift uicomponent uikit xcode

Last synced: about 2 months 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 (about 2 years ago)
Last Synced: 2024-11-18T05:33:35.825Z (2 months 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.