DGNotifyView

KO | EN

gitlite — search

#python #java #python3 #arduino #golang #machine-learning #rust #html #flask #javascript #seismology #nodejs

★ 18 Open GitHub ↗

Animated view for internal app notifications

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# DGNotifyView

[![Codacy Badge](https://api.codacy.com/project/badge/Grade/f815aa4a8c734a938260d6e56f88b455)](https://www.codacy.com/app/glowcap/DGNotifyView?utm_source=github.com&amp;utm_medium=referral&amp;utm_content=glowcap/DGNotifyView&amp;utm_campaign=Badge_Grade)
[![Swift](https://img.shields.io/badge/%20compatible-swift%205.0-orange.svg)](http://swift.org)
[![Version](https://img.shields.io/cocoapods/v/DGNotifyView.svg?style=flat)](http://cocoapods.org/pods/DGNotifyView)
[![License](https://img.shields.io/cocoapods/l/DGNotifyView.svg?style=flat)](http://cocoapods.org/pods/DGNotifyView)
[![Platform](https://img.shields.io/cocoapods/p/DGNotifyView.svg?style=flat)](http://cocoapods.org/pods/DGNotifyView)

DGNotifyView is a Swift-based framework that allows you to create quick, customizable in-app notification views. The notification can include an image, have rounded corners, and best of all they're preprogrammed with animations to slide (or spring!) into view from six different directions. You can even set the notification’s display duration!

![Screenshot](https://cloud.githubusercontent.com/assets/10408147/22461391/6da12fa0-e7ec-11e6-9209-8fd1e15d05da.png)

## Example
To run the example project, clone the repo, and run `pod install` from the Example directory first.

## Requirements
You need to import `UIKit`...obviously. ;)

## Installation
DGNotifyView is available through [CocoaPods](http://cocoapods.org). To install
it, simply add the following line to your Podfile:

```ruby
pod "DGNotifyView"
```
### Static Library (manual)
If you prefer to install it manually, copy the files under the DGNotifyView subdirectory into your project. If your application is written in Swift, there’s no need for a bridging header.

## Usage
DGNotifyView allows you to set parameters for:

- Notification corner radius (applies to both notification & image) 
- Adding a square image
- The direction the notification will appear from
- Spring or Standard animation (Boing!)
- Display duration

#### Initializing
Since DGNotifyView is based on UIView, you’ll need to `import UIKit` where you are initializing DGNotifyView. Then:

```swift
import DGNotifyView
```
To add a notification, create an instance of your preferred view with the required information and where you want the view to appear from:

```swift
let myNotif = DGNotifyView(title: "My Title", message: "Important message")
```
Don’t forget to add it to your view when you’re ready to use it:

```swift
self.view.addSubview(myNotif)
```

#### Customizing
You can change the defalut color of the text and background by calling `set(textColor: UIColor?, backgroundColor: UIColor?)`
(removing a parameter leave the color set to the default):

```swift
myNotif.set(textColor: UIColor.red, backgroundColor: UIColor.darkGray)
```

#### Animating
Once you have an instance of DGNotifyView, you can call it to slide in with how long it should be displayed. This function ends with a closure in case you want to do something after the animation is completed:

```swift
myNotif.displayFor(seconds: 1.0) { (finished) in
            if finished {
               // your code here
            }
        }
```

## To-Do List
There are a few things I’d like to add in the future:
- [ ] ~~Add ability to set custom colors for text and background~~
- [ ] ~~Set custom font~~
- [ ] ~~Spring animation option~~
- [ ] Swipe out of view

## Contributing
If your interested in contributing:

1. Fork it.
2. Create your feature branch `git checkout -b new-feature`
3. Commit your changes `git commit -am ‘Added new-feature`
4. Push to the branch `git push origin new-feature`
5. Create a new Pull Request

## Author

Daymein Gregorio, [@DaymeinG](https://twitter.com/DaymeinG)

## License

DGNotifyView is available under the MIT license. See the LICENSE file for more info.

DGNotifyView

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README