ADVHelper

• Requirements
• Installation
• Usage
  • ADVHelper
  • Localize
  • String Extension
  • Label
  • TextField
  • TextView
  • ImageView
  • View
  • TableView
  • CollectionView
• Example
• Author
• License
• Credits

Requirements

iOS 12.0 or above

Installation

ADVHelper is available through CocoaPods. To install it, simply add the following line to your Podfile:

pod 'ADVHelper'

Usage

- ADVHelper

Using ADVHelper programmatically

Import ADVHelper at the top of each Swift file that will be used.

import ADVHelper

- Localize

Using Localize programmatically

Add .localized() following any String object you want translated:

let _ = "String".localized()

To change the current language:

Localize.setCurrentLanguage("th")

To update the UI in the view controller where a language change can take place, observe LCLLanguageChangeNotification:

NotificationCenter.default.addObserver(self, selector: #selector(setText), name: NSNotification.Name(LCLLanguageChangeNotification), object: nil)

Example function setText()

@objc func setText() {
    titleLabel.localizeKey = "String".localized()
    textFieldBox.localizeKey = "String".localized()
    textViewBox.localizeKey = "String".localized()
    buttonBtn.localizeKey = "String".localized()
}

- String Extension

Using String Extension programmatically

- DateFormatter

• Function dateFormat for set output format

In this function, it supports the input formats yyyy-MM-dd HH: mm: ss and yyyy-MM-dd. And default local date for input en. And local date for output are based on Localize Language.

Example input date

let inputDateStr = "2020-06-17 10:20:30"

Example of use

titleLabel.text = inputDateStr.dateFormat(format: "dd/MM/yyyy HH:mm")

Output

17/06/2020 10:20

• Function dateFormat for set fromFormat and toFormat

In this function, it default local date for input en. And local date for output are based on Localize Language.

Example input date

let inputDateStr = "2020-06-17 10:20:30"

Example of use

titleLabel.text = inputDateStr.dateFormat(fromFormat: "yyyy-MM-dd HH:mm:ss", toFormat: "dd/MM/yyyy HH:mm")

Output

17/06/2020 10:20

• Function dateFormat for set fromFormat toFormat and toLocaleIdentifier

In this function, it default local date for input en.

Example input date

let inputDateStr = "2020-06-17 10:20:30"

Example of use

titleLabel.text = inputDateStr.dateFormat(fromFormat: "yyyy-MM-dd HH:mm:ss", toFormat: "dd/MM/yyyy HH:mm", toLocaleIdentifier: "th")

Output

17/06/2563 10:20

• Function dateFormat for all set fromFormat fromLocaleIdentifier toFormat and toLocaleIdentifier

Example input date

let inputDateStr = "2563-06-17 10:20:30"

Example of use

titleLabel.text = inputDateStr.dateFormat(fromFormat: "yyyy-MM-dd HH:mm:ss", fromLocaleIdentifier: "th", toFormat: "dd/MM/yyyy HH:mm", toLocaleIdentifier: "en")

Output

17/06/2020 10:20

- Button

Using Button programmatically

Connect the UI to Code

@IBOutlet weak var buttonBtn: Button!

- Localize

Define text with localizeKey

buttonBtn.localizeKey = "Button".localized()

- Loading

To show a loader inside the button, and enable or disable user interection while loading

buttonBtn.showLoader()

To hide a loader

buttonBtn.hideLoader()

Using Button in Storyboard

The steps for use

1. Drag a UIButton into Storyboard.
2. Set class to Button
3. Set up attributes inspection.

- Border

- Corner Radius

- Shadow

- Gradient Background

- Click Animate

- Ripple

- Image

- Underline

- Label

Using Label programmatically

Connect the UI to Code

@IBOutlet weak var titleLabel: Label!

- Localize

Define text with localizeKey

titleLabel.localizeKey = "Label".localized()

Using Label in Storyboard

The steps for use

1. Drag a UILabel into Storyboard.
2. Set class to Label
3. Set up attributes inspection.

- Border

- Corner Radius

- Shadow

- Underline

- TextField

Using TextField programmatically

Connect the UI to Code

@IBOutlet weak var textFieldBox: TextField!

- Localize

Define placeholder with localizeKey

textFieldBox.localizeKey = "Placeholder".localized()

Using TextField in Storyboard

The steps for use

1. Drag a UITextField into Storyboard.
2. Set class to TextField
3. Set up attributes inspection.

- Border

- Corner Radius

- Shadow

- Gradient Background

- Padding

Left: 0, Right: 0	Left: 8, Right: 0	Left: 0, Right: 8	Left: 8, Right: 8

- TextView

Using TextView programmatically

Connect the UI to Code

@IBOutlet weak var textViewBox: TextView!

- Localize

Define placeholder with localizeKey

textViewBox.localizeKey = "Placeholder".localized()

Using TextView in Storyboard

The steps for use

1. Drag a UITextView into Storyboard.
2. Set class to TextView
3. Set up attributes inspection.

- Border

- Corner Radius

- Maximum length

- Trim

- Height

- Padding

- ImageView

Using ImageView programmatically

Connect the UI to Code

@IBOutlet weak var imageView: ImageView!

Using ImageView in Storyboard

The steps for use

1. Drag a UIImageView into Storyboard.
2. Set class to ImageView
3. Set up attributes inspection.

- Border

- Corner Radius

- View

Using View programmatically

Connect the UI to Code

@IBOutlet weak var view: View!

Using View in Storyboard

The steps for use

1. Drag a UIView into Storyboard.
2. Set class to View
3. Set up attributes inspection.

- Border

- Corner Radius

- Shadow

- Gradient Background

- TableView

Using TableView programmatically

Connect the UI to Code

@IBOutlet weak var dataTableView: TableView!

- Image Size

Custom Size Image

dataTableView.imageSizePercentage = .percentage75

- Color & Font

Custom Color & Font

dataTableView.titleColor = UIColor.black
dataTableView.titleFont = UIFont(name: "HelveticaNeue-Bold", size: 18)
dataTableView.messageColor = UIColor.lightGray
dataTableView.messageFont = UIFont(name: "HelveticaNeue-Regular", size: 17)

- Empty View

Example of use in numberOfRowsInSection

func tableView(_ tableView: UITableView, numberOfRowsInSection section: Int) -> Int {
    if names.count == 0 {
        dataTableView.setEmptyView(title: "Oops!", message: "Data not found.", messageImage: #imageLiteral(resourceName: "data_not_found_icon"), animated: true)
    } else {
        dataTableView.restore()
    }
    
    return names.count
}

• Function setEmptyView for show image only.

Example of use

dataTableView.setEmptyView(messageImage: #imageLiteral(resourceName: "no_data_icon"), animated: true)

Output

• Function setEmptyView for show title only.

Example of use

dataTableView.setEmptyView(title: "Data not found.")

Output

• Function setEmptyView for show title and message.

Example of use

dataTableView.setEmptyView(title: "Oops!", message: "Data not found.")

Output

• Function setEmptyView for show image and title and message.

Example of use

dataTableView.setEmptyView(title: "Oops!", message: "Data not found.", messageImage: #imageLiteral(resourceName: "data_not_found_icon"), animated: true)

Output

- Restore

The restore TableView

Example of use

dataTableView.restore()

Using TableView in Storyboard

The steps for use

1. Drag a UITableView into Storyboard.
2. Set class to TableView
3. Set up attributes inspection.

- Border

- CollectionView

Using CollectionView programmatically

Connect the UI to Code

@IBOutlet weak var dataCollectionView: CollectionView!

- Image Size

Custom Size Image

dataCollectionView.imageSizePercentage = .percentage75

- Color & Font

Custom Color & Font

dataCollectionView.titleColor = UIColor.black
dataCollectionView.titleFont = UIFont(name: "HelveticaNeue-Bold", size: 18)
dataCollectionView.messageColor = UIColor.lightGray
dataCollectionView.messageFont = UIFont(name: "HelveticaNeue-Regular", size: 17)

- Empty View

Example of use in numberOfItemsInSection

func collectionView(_ collectionView: UICollectionView, numberOfItemsInSection section: Int) -> Int {
    if names.count == 0 {
        dataCollectionView.setEmptyView(title: "Oops!", message: "Data not found.", messageImage: #imageLiteral(resourceName: "data_not_found_icon"), animated: true)
    } else {
        dataCollectionView.restore()
    }
    
    return names.count
}

• Function setEmptyView for show image only.

Example of use

dataCollectionView.setEmptyView(messageImage: #imageLiteral(resourceName: "no_data_icon"), animated: true)

Output

• Function setEmptyView for show title only.

Example of use

dataCollectionView.setEmptyView(title: "Data not found.")

Output

• Function setEmptyView for show title and message.

Example of use

dataCollectionView.setEmptyView(title: "Oops!", message: "Data not found.")

Output

• Function setEmptyView for show image and title and message.

Example of use

dataCollectionView.setEmptyView(title: "Oops!", message: "Data not found.", messageImage: #imageLiteral(resourceName: "data_not_found_icon"), animated: true)

Output

- Restore

The restore CollectionView

Example of use

dataCollectionView.restore()

Using CollectionView in Storyboard

The steps for use

1. Drag a UICollectionView into Storyboard.
2. Set class to CollectionView
3. Set up attributes inspection.

- Border

Example

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

Author

nattaponph, [email protected]

License

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

Credits

• Kenneth Tsang
• Roy Marmelstein
• Taha Sönmez