ZAlertView

KO | EN

gitlite — search

#hacktoberfest #react #llm #android #machine-learning #rust #linux #docker #nodejs #cli #kubernetes #pytorch #ios #mcp

(★ 140)

A "quite" cool customizable AlertView written in Swift.

File Explorer

Download Latest Version (.zip)

- - Manifest.lock
- - Info.plist
  - Tests.swift
- - AppDelegate.swift
  - Info.plist
  - ViewController.swift
- - project.pbxproj
- - contents.xcworkspacedata
- Podfile
- Podfile.lock
- - .gitkeep
- - .gitkeep
  - UIColor.swift
  - UIImage.swift
  - ZAlertView.swift
- ZA_01.png
- ZA_02.png
- ZA_03.png
- ZA_04.png
.gitignore
.travis.yml
_Pods.xcodeproj
LICENSE
README.md
ZAlertView.podspec

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# ZAlertView - AlertView written in Swift

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

![alt text](https://raw.githubusercontent.com/zelic91/ZAlertView/master/Screenshots/ZA_01.png "")
![alt text](https://raw.githubusercontent.com/zelic91/ZAlertView/master/Screenshots/ZA_02.png "")
![alt text](https://raw.githubusercontent.com/zelic91/ZAlertView/master/Screenshots/ZA_03.png "")
![alt text](https://raw.githubusercontent.com/zelic91/ZAlertView/master/Screenshots/ZA_04.png "")

## Introduction

ZAlertView is a highly customizable dialog (exaggerated, right?) view which can be used as a substitution for UIAlertView. It's written in Swift. This is the gift I give to myself on my 26th birthday.

## Import

For Swift

```swift
  import ZAlertView
```

For Objective-C

```objective-c
  #import "ZAlertView-Swift.h"
```

## Usage

There are 3 types of dialog that ZAlertView currently supports: Alert, Confirmation (Yes/No) and  Multiple choice. TextFields can also be added to any of those types.

```swift
  public enum AlertType: Int {
    case Alert
    case Confirmation
    case MultipleChoice
  }
```

To create and show a dialog, first of all, import the module at the beginning of the file:

```swift
  import ZAlertView
```

Then show the dialog as below:

```swift
  let dialog = ZAlertView()
  dialog.show()
```

There are more convenient constructors for you to use:

```swift
  ZAlertView(title: "Title", message: "Message", alertType: AlertType.Alert)

ZAlertView(title: "Title", message: "Message", closeButtonText: "Close this popup", closeButtonHandler: nil)

ZAlertView(title: "Title", message: "Message", okButtonText: "Sure, I do", cancelButtonText: "No way")

ZAlertView(title: "Title", message: "Message", isOkButtonLeft: false, okButtonText: "Cool, do it", cancelButtonText: "Stop it", okButtonHandler: nil, cancelButtonHandler: nil)
```

And button handler (TouchHandler) is just a lambda:

```swift
  (ZAlertView) -> ()
```

There are plenty of attributes that you can use to make your own style for the whole app:

```swift
  public static var padding: CGFloat
  public static var innerPadding: CGFloat
  public static var cornerRadius: CGFloat
  public static var buttonHeight: CGFloat
  public static var buttonSectionExtraGap: CGFloat
  public static var textFieldHeight: CGFloat
  public static var backgroundAlpha: CGFloat
  public static var blurredBackground: Bool
  public static var showAnimation: ShowAnimation
  public static var hideAnimation: HideAnimation

// Font
  public static var alertTitleFont: UIFont?
  public static var messageFont: UIFont?
  public static var buttonFont: UIFont?

// Color
  public static var positiveColor: UIColor?
  public static var negativeColor: UIColor?
  public static var neutralColor: UIColor?
  public static var titleColor: UIColor?
  public static var messageColor: UIColor?
  public static var cancelTextColor: UIColor?
  public static var normalTextColor: UIColor?

//Text field style
  public static var textFieldTextColor: UIColor?
  public static var textFieldBorderColor: UIColor?
  public static var textFieldBackgroundColor: UIColor?
```

There are also some basic animations:

```swift
  public enum ShowAnimation: Int {
    case FadeIn
    case FlyLeft
    case FlyTop
    case FlyRight
    case FlyBottom
  }

public enum HideAnimation: Int {
    case FadeOut
    case FlyLeft
    case FlyTop
    case FlyRight
    case FlyBottom
  }
```

For a specific dialog, there are customizable properties as below:

```swift
  public var alertType: AlertType
  public var alertTitle: String?
  public var message: String?
  public var okTitle: String?
  public var cancelTitle: String?
  public var closeTitle: String?
  public var isOkButtonLeft: Bool
  public var allowTouchOutsideToDismiss: Bool
  public var width: CGFloat = ZAlertView.AlertWidth
  public var height: CGFloat = ZAlertView.AlertHeight

// Master views
  public var backgroundView: UIView!
  public var alertView: UIView!
```

For dialogs that need multiple buttons, please use AlertType.MultipleChoice. In such case, use the convenient method to add buttons to the dialog. Cool things is that we can use hex color directly here:

```swift
  public func addButton(title: "Button", touchHandler: TouchHandler)

public func addButton(title: "Button", color: UIColor?, titleColor: UIColor?, touchHandler: TouchHandler)

public func addButton(title: "Button", hexColor: String, hexTitleColor: String, touchHandler: TouchHandler)

public func addButton(title: "Button", font: UIFont, touchHandler: TouchHandler)

public func addButton(title: "Button", font: UIFont, color: UIColor?, titleColor: UIColor?, touchHandler: TouchHandler)
```

Similarly, we can also add textfields to the dialog. Each textfield needs an identifier for later manipulation:

```swift
  public func addTextField(identifier: String, placeHolder: String)

public func addTextField(identifier: String, placeHolder: String, isSecured: Bool)

public func addTextField(identifier: String, placeHolder: String, keyboardType: UIKeyboardType)

public func addTextField(identifier: String, placeHolder: String, keyboardType: UIKeyboardType, font: UIFont, padding: CGFloat, isSecured: Bool)
```

To get a textfield:

```swift
  public func getTextFieldWithIdentifier(identifier: String) -> UITextField?
```

## Installation

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

```ruby
pod 'ZAlertView'
```

## Author

Thuong Nguyen, thuongnh.uit@gmail.com

## License

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

ZAlertView

File Explorer

Today's picks

Was this content helpful?

Recent Feedback

ZAlertView

File Explorer

Today's picks

Was this content helpful?

Recent Feedback

Download README