[Swift通天遁地]二、表格表单-(8)快速实现表单的输入验证

★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★
➤微信公众号：山青咏芝（shanqingyongzhi）
➤博客园地址：山青咏芝（https://www.cnblogs.com/strengthen/）
➤GitHub地址：https://github.com/strengthen/LeetCode
➤原文地址：https://www.cnblogs.com/strengthen/p/10193784.html 
➤如果链接不是山青咏芝的博客园地址，则可能是爬取作者的文章。
➤原文已修改更新！强烈建议点击原文地址阅读！支持作者！支持原创！
★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★

目录：[Swift]通天遁地Swift

本文将演示如何快速实现表单是输入验证。

首先确保在项目中已经安装了所需的第三方库。

点击【Podfile】,查看安装配置文件。

platform :ios, '12.0'
use_frameworks!

target 'DemoApp' do
    source 'https://github.com/CocoaPods/Specs.git'
    pod 'SwiftValidator', :git => 'https://github.com/jpotts18/SwiftValidator.git', :branch => 'master'
end

根据配置文件中的相关配置，安装第三方库。

然后点击打开【DemoApp.xcworkspace】项目文件。

在项目导航区，打开故事版文件【Main.storyboard】

打开控件库，插入一个标签控件。点击【属性检查器】，进入属性设置面板。

设置标签默认文字的内容。拖动标签控件，增加标签控件的宽度。

再次插入一个标签到故事板中，设置文字内容右对齐，

该标签将用来显示表单验证时的错误信息。

往故事板中插入一个输入框，设置文本框的占位文字。

继续添加其他的控件，直到完成整个表单的制作。

再给表单添加一个提交按钮，设置按钮控件的标题文字：【Submit】

背景色：【Background】

前景色:【Tint】

在项目导航区，打开视图控制器的代码文件【ViewController.swift】

现在开始编写代码，实现表单的输入验证功能。

import UIKit
//在当前的类文件中引入已经安装的第三方类库
import SwiftValidator

//使视图控制器类遵循表单验证协议。
class ViewController: UIViewController,ValidationDelegate {
    
    //创建五个文本框属性，
    //这五个文本框属性，将和故事板的五个文本框控件进行连接。
    @IBOutlet weak var fullNameTextField: UITextField!
    @IBOutlet weak var emailTextField: UITextField!
    @IBOutlet weak var phoneNumberTextField: UITextField!
    @IBOutlet weak var zipcodeTextField: UITextField!
    @IBOutlet weak var emailConfirmTextField: UITextField!
    
    //创建五个标签属性，
    //这五个标签属性，将和故事板的五个标签控件进行连接。
    //用来显示表单验证的错误信息。
    @IBOutlet weak var fullNameErrorLabel: UILabel!
    @IBOutlet weak var emailErrorLabel: UILabel!
    @IBOutlet weak var phoneNumberErrorLabel: UILabel!
    @IBOutlet weak var zipcodeErrorLabel: UILabel!
    @IBOutlet weak var emailConfirmErrorLabel: UILabel!
    
    //初始化一个表单验证器对象
    let validator = Validator()
    
    override func viewDidLoad() {
        super.viewDidLoad()
        
        //给视图添加一个触摸手势，用来关闭由于文本框控件处于焦点时，所弹出的键盘。
        self.view.addGestureRecognizer(UITapGestureRecognizer(target: self, 
                                                              action: #selector(ViewController.hideKeyboard)))
        
        //设置验证器的外观样式
        validator.styleTransformers(
            //设置当验证成功时的样式
            success:{ (validationRule) -> Void in
            //设置错误提示标签处于隐藏状态
            validationRule.errorLabel?.isHidden = true
            //设置错误提示标签的内容为空的字符串
            validationRule.errorLabel?.text = ""
            //对文本框进行一些外观的设置
            if let textField = validationRule.field as? UITextField
            {
                //设置文本框的层的边框颜色为绿色
                textField.layer.borderColor = UIColor.green.cgColor
                //设置文本框的边框的宽度为1
                textField.layer.borderWidth = 1.0
            }
            }, 

            //接着设置当验证失败时的样式
            error:{(validationError) -> Void in
            //设置错误提示标签处于显示状态
            validationError.errorLabel?.isHidden = false
            //设置错误提示标签的内容为错误的提示消息
            validationError.errorLabel?.text = validationError.errorMessage
            //对文本框进行一些外观的设置
            if let textField = validationError.field as? UITextField
            {
                //设置文本框的层的边框颜色为红色
                textField.layer.borderColor = UIColor.red.cgColor
                //设置文本框的边框的宽度为1
                textField.layer.borderWidth = 1.0
            }
        })
        
        //给验证器对象，注册需要进行验证的文本框，以验证失败时的错误标签
        //同时还设置了两个验证时的规则，即进行非空验证和全名验证
        validator.registerField(fullNameTextField,
                                errorLabel: fullNameErrorLabel ,
                                rules: [RequiredRule(),
                                FullNameRule()])

        //进行非空验证和邮箱格式验证
        validator.registerField(emailTextField, 
                                errorLabel: emailErrorLabel,
                                rules: [RequiredRule(), 
                                EmailRule()])

        //增加了一个匹配验证的规则，以保证两个邮箱文本框，具有相同的内容。
        validator.registerField(emailConfirmTextField,
                                errorLabel: emailConfirmErrorLabel, 
                                rules: [RequiredRule(), 
                                ConfirmationRule(confirmField: emailTextField)])

        //增加了一个最小长度的验证，以验证是否输入了9个以上的字符
        validator.registerField(phoneNumberTextField, 
                                 errorLabel: phoneNumberErrorLabel, 
                                rules: [RequiredRule(), 
                                MinLengthRule(length: 9)])
        //增加了一个邮政编码格式的验证条件
        validator.registerField(zipcodeTextField,
                                errorLabel: zipcodeErrorLabel, 
                                rules: [RequiredRule(), 
                                ZipCodeRule()])
    }
    
    //添加一个方法，用来响应提交按钮的点击事件。
    //该方法将为故事板中的提交按钮进行连接
    @IBAction func submitTapped(_ sender: AnyObject)
    {
        //在控制台输出日志
        print("Validating...")
        //并调用验证器进行表单的验证操作。
        validator.validate(self)
    }
    
    //添加一个方法，当验证成功时调用该方法。
    func validationSuccessful()
    {
        //在控制台输出验证成功的语句
        print("Validation Success!")
        //创建一个警告窗口，显示验证成功的信息。
        let alert = UIAlertController(title: "Success",
                                      message: "You are validated!", 
                                      preferredStyle: UIAlertControllerStyle.alert)
        //给警告窗口添加一个按钮，用于关闭警告窗口。
        let defaultAction = UIAlertAction(title: "OK", style: .default, handler: nil)
        alert.addAction(defaultAction)
        //在当前的视图控制器中，以模态的方式打开警告窗口。
        self.present(alert, animated: true, completion: nil)
    }
    
    //添加一个方法，当验证失败时调用该方法。
    func validationFailed(_ errors:[(Validatable, ValidationError)])
    {
        print("Validation FAILED!")
    }
    
    //添加一个方法，当用户点击根视图时，隐藏弹出的键盘
    func hideKeyboard()
    {
        self.view.endEditing(true)
    }
}

在项目导航区，打开故事版文件【Main.storyboard】

点击【显示辅助编辑器】按钮，显示辅助编辑器。

在代码编辑区名称属性左侧的连接提示图标上点击，并拖动到所需要连接到的控件。