Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/morizotter/SwiftyDrop

Lightweight dropdown message bar in Swift. It's simple and beautiful.
https://github.com/morizotter/SwiftyDrop

Last synced: 3 months ago
JSON representation

Lightweight dropdown message bar in Swift. It's simple and beautiful.

Host: GitHub
URL: https://github.com/morizotter/SwiftyDrop
Owner: morizotter
License: mit
Archived: true
Created: 2015-06-20T19:24:00.000Z (over 9 years ago)
Default Branch: master
Last Pushed: 2019-03-29T01:01:59.000Z (over 5 years ago)
Last Synced: 2024-08-07T06:02:09.250Z (3 months ago)
Language: Swift
Homepage:
Size: 12.4 MB
Stars: 684
Watchers: 14
Forks: 74
Open Issues: 13
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

awesome-ios - SwiftyDrop - SwiftyDrop is a lightweight pure Swift simple and beautiful dropdown message. (UI / Alert & Action Sheet)
awesome-swift - SwiftyDrop - Lightweight dropdown message bar. (Libs / UI)
awesome-ios-star - SwiftyDrop - SwiftyDrop is a lightweight pure Swift simple and beautiful dropdown message. (UI / Alert & Action Sheet)
awesome-swift-cn - SwiftyDrop - Lightweight dropdown message bar in Swift. (Libs / UI)
Awesome-Mobile-UI - SwiftyDrop
awesome-swift - SwiftyDrop - Lightweight dropdown message bar in Swift. It's simple and beautiful. ` 📝 3 years ago` (UI [🔝](#readme))

README

        # SwiftyDrop

SwiftyDrop is a lightweight pure Swift simple and beautiful dropdown message.

[![Version](https://img.shields.io/cocoapods/v/SwiftyDrop.svg?style=flat)](http://cocoadocs.org/docsets/SwiftyDrop) [![License](https://img.shields.io/cocoapods/l/SwiftyDrop.svg?style=flat)](http://cocoadocs.org/docsets/SwiftyDrop) [![Platform](https://img.shields.io/cocoapods/p/SwiftyDrop.svg?style=flat)](http://cocoadocs.org/docsets/SwiftyDrop)

[![Carthage compatible](https://img.shields.io/badge/Carthage-compatible-4BC51D.svg?style=flat)](https://github.com/Carthage/Carthage)

[![Join the chat at https://gitter.im/morizotter/SwiftyDrop](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/morizotter/SwiftyDrop?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)

## Features

- Easy to use like: `Drop.down("Message")`

- Message field expands depending on the message.

## How it looks

### States

![Default](misc/Default.png)

![Success](misc/Success.png)

![Warning](misc/Warning.png)

![Error](misc/Error.png)

### Blurs

![Light](misc/Light.png)

![Dark](misc/Dark.png)

### iPhone X

![iPhoneX](misc/iPhoneX.png)

### iPad

![iPad](misc/iPadPortlait.png)

## Demo

Git clone or download this repository and open  **SwiftyDrop.xcodeproj** . You can try SwiftyDrop in your Mac or iPhone.

## Runtime Requirements

- iOS8.0 or later

- Xcode 9.0

- Swift 4.0

## Installation and Setup

**Note:** Embedded frameworks require a minimum deployment target of iOS 8.1.

**Information:** To use SwiftyDrop with a project targeting iOS 8.0 or lower, you must include the `SwiftyDrop/Drop.swift` source file directly in your project.

### Installing with CocoaPods

[CocoaPods](http://cocoapods.org) is a centralised dependency manager that automates the process of adding libraries to your Cocoa application. You can install it with the following command:

```bash

$ gem update

$ gem install cocoapods

$ pods --version

```

To integrate SwiftyDrop into your Xcode project using CocoaPods, specify it in your `Podfile` and run `pod install`.

```bash

platform :ios, '8.0'

use_frameworks!

pod 'SwiftyDrop', '~>4.0'

```

### Installing with Carthage

Just add to your Cartfile:

```ogdl

github "morizotter/SwiftyDrop" ~> 4.0

```

### Manual Installation

To install SwiftyDrop without a dependency manager, please add all of the files in `/SwiftyDrop` to your Xcode Project.

## Usage

### Basic

To start using SwiftyDrop, write the following line wherever you want to show dropdown message:

```swift

import SwiftyDrop

```

Then invoke SwiftyDrop, by calling:

```swift

Drop.down("Message")

```

It is really simple!

### States

SwiftyDrop has states of display.

**Examples**

```swift

Drop.down("Message")

Drop.down("Message", state: .Success)

Drop.down("Message", state: .Color(.orangeColor()))

Drop.down("Message", state: .Blur(.Light))

```

**Custom states**

You can customize looks by comforming `DropStatable` protocol.

Examples are:

```swift

enum Custom: DropStatable {

    case BlackGreen

    var backgroundColor: UIColor? {

        switch self {

        case .BlackGreen: return .blackColor()

        }

    }

    var font: UIFont? {

        switch self {

        case .BlackGreen: return UIFont(name: "HelveticaNeue-Light", size: 24.0)

        }

    }

    var textColor: UIColor? {

        switch self {

            case .BlackGreen: return .greenColor()

        }

    }

    var blurEffect: UIBlurEffect? {

        switch self {

        case .BlackGreen: return nil

        }

    }

}

Drop.down(self.sampleText(), state: Custom.BlackGreen)

```

Of course you can use class or struct to make custom state if it is comforming to `DropStatable` protocol.

**Prepared States** are enum:

- .Default

- .Info

- .Success

- .Warning

- .Error

- .Color: UIColor

- .Blur: UIBlurEffectStyle

### Duration

```swift

Drop.down("Message", duration: 3.0)

```

You can change duration like this above. Default duration is 4.0.

### Action

```swift

Drop.down("Message") {

    print("Action fired!")

}

```

## Contribution

Please file issues or submit pull requests! We're waiting! :)

## License

SwiftyDrop is released under the MIT license. Go read the LICENSE file for more information.