PasswordTextField

A custom TextField with a switchable icon which shows or hides the password and enforce good password policies

Code Quality Rank: L5

Programming language: Swift

License: MIT License

Tags: UI     TextField & TextView    

Latest version: v1.2.0

README

PasswordTextField

A custom TextField with a switchable icon which shows or hides the password and enforces good password policies, written in Swift.

:star: Features

• Custom toggle icon in IB or programmatically.
• Custom icon color in IB or programmatically.
• Custom password validation rules.
• Custom password validation error message.
• Control when to show the icon, while editing, always or never.

:octocat: Installation

CocoaPods

You can use CocoaPods to install PasswordTextField by adding it to your Podfile:

platform :ios, '8.0'
use_frameworks!
pod 'PasswordTextField'

To get the full benefits import PasswordTextField wherever you import UIKit

import UIKit
import PasswordTextField

Carthage

Create a Cartfile that lists the framework and run carthage bootstrap. Follow the instructions to add $(SRCROOT)/Carthage/Build/iOS/PasswordTextField.framework to an iOS project.

github "PiXeL16/PasswordTextField"

Manually

1. Download and drop /PasswordTextField folder in your project.
   
2. Congratulations!
   

:metal: Usage

1. Open a storyboard or Xib file.
2. Drag and drop a UITextField to a ViewController.
3. In Identity Inspector, replace the class from UITextField to PasswordTextField and the module to PasswordTextField.
4. Configure your properties in the Attribute Inspector.

[Screenshot](Web/storyboardScreenshot.png)

Properties

Property name	Data type	Remark
Show Toggle Button While	String	Possible values are editing(default), always, never
Image Tint Color	UIColor	The color off the Toggle image, the functionality use UIImageRenderingMode.AlwaysTemplate to change the default or custom image color
Custom Show Secure Text Image	UIImage	Your custom image to show the secure text
Custom Hide Secure Text Image	UIImage	Your custom image to hide the secure text

Validation

PasswordTextField also provides functionality to enforce good password policies.

It will currently validate that the password format is at least 8 characters long and contain one uppercase letter and one number.

import PasswordTextField

if passwordTextField.isInvalid(){
  print(passwordTextField.errorMessage)
}

You can also provide your custom password validation format (with Regex) and error message:

import PasswordTextField

let validationRule = RegexRule(regex:"^[A-Z ]+$", errorMessage: "Password must contain only uppercase letters")

passwordTextField.validationRule = validationRule

if passwordTextField.isInvalid(){
  print(passwordTextField.errorMessage)
}

TODO

• Show indication when password is strong or weak in TextField
• Animation when toggling Button

:alien: Author

Chris Jimenez - http://code.chrisjimenez.net, @chrisjimeneznat

:beer: Donate

If you want to buy me a beer, you can donate to my coin addresses below:

BTC

1BeGBew4CBdLgUSmvoyiU1LrM99GpkXgkj

ETH

0xa59a3793E3Cb5f3B1AdE6887783D225EDf67192d

LTC

Ld6FB3Tqjf6B8iz9Gn9sMr7BnowAjSUXaV

License

PasswordTextField is released under the MIT license. See LICENSE for details.