Swift - SwiftForms的使用详解（第三方Form表单组件 ）

import SwiftForms

二、使用说明

• 第一个分区有两个表单项，分别可以输入普通文字和密码。
• 第二个分区只有一个按钮。

三、自带的表单元素类型

1，普通的文本标签（label）

var row = FormRowDescriptor(tag: "test", type: .label, title: "这时一个文本标签单元格")
row.configuration.cell.placeholder = "右侧文字"

2，普通的文本输入（text）

         

var row = FormRowDescriptor(tag: "test", type: .text, title: "用户名")
row.configuration.cell.placeholder = "你的工号"

（2）可以设置默认值，以及输入框文字靠右显示。

row.configuration.cell.appearance["textField.textAlignment"]
    = NSTextAlignment.right.rawValue as AnyObject
row.value = "A007" as AnyObject

3，特殊的文本输入

1，效果图

           

2，样例代码

var row = FormRowDescriptor(tag: "count", type: .stepper, title: "计数")
//允许的最大值
row.configuration.stepper.maximumValue = 200.0
//允许的最小值
row.configuration.stepper.minimumValue = 20.0
//每次增减的值
row.configuration.stepper.steps = 2.0
//该表单元素值改变时的响应
row.configuration.cell.didUpdateClosure = { row in
    print("--- 值发生改变 ---")
    print("type：\(row.type)")
    print("tag：\(row.tag)")
    print("title：\(row.title!)")
    print("value：\(row.value!)")
}

四、外观样式的修改

1，设置样式

//标题文字样式修改
row.configuration.cell.appearance["titleLabel.font"] = UIFont.boldSystemFont(ofSize: 30.0)
//分段选择控件颜色修改
row.configuration.cell.appearance["segmentedControl.tintColor"] = UIColor.red

2，单元格头部添加图标

override func tableView(_ tableView: UITableView, cellForRowAt indexPath: IndexPath)
    -> UITableViewCell {
    //获取默认单元格
    let cell = super.tableView(tableView, cellForRowAt: indexPath)
    //如果是第一个单元格则添加邮件图标
    if indexPath.section == 0 && indexPath.row == 0 {
        cell.imageView?.image = UIImage(named: "mail.png")
    }
    return cell
}

五、创建自定义单元格

虽然 SwiftForms 已经提供了各种类型的单元格供我们使用，但有时可能还不能满足需求。通过继承 FormBaseCell，我们可以很方便的实现我们自己的表单 cell。继承后记得要实现如下两个方法：

• configure：这个只有在 cell 创建完毕后会调用一次。
• update：每次 cell 内容需要刷新的时候都会调用。

1，效果图

这里自定义一个简单的表单 cell，其内部左侧显示一个圆形的图标，右侧是文本输入框。

2，组件代码（MyImageHeadCell.swift）

import UIKit
import SwiftForms

class MyImageHeadCell: FormBaseCell {
    
    //左侧图片视图
    open let headImageView = UIImageView()
    
    //右侧输入框
    open let textField  = UITextField()
    
    //初始化配置（只会在单元格创建完毕后调用一次）
    override func configure() {
        super.configure()
        
        //去除选中样式
        selectionStyle = .none
        
        //图片保持比例缩放
        headImageView.contentMode = .scaleAspectFill
        //设置遮罩
        headImageView.layer.masksToBounds = true
    
        //输入框文字样式
        textField.font = UIFont.preferredFont(forTextStyle: UIFontTextStyle.body)
        //输入框内容编辑响应时间
        textField.addTarget(self, action: #selector(MyImageHeadCell.editingChanged(_:)),
                            for: .editingChanged)
        
        //将组件添加到视图中
        contentView.addSubview(headImageView)
        contentView.addSubview(textField)
    }
    
    //每次需要更新单元格是都会调用
    override func update() {
        super.update()
        
        //设置输入框文字
        textField.text = rowDescriptor?.value as? String
        textField.placeholder = rowDescriptor?.configuration.cell.placeholder
        textField.isSecureTextEntry = false
        textField.clearButtonMode = .whileEditing
    }
    
    //布局
    override func layoutSubviews() {
        super.layoutSubviews()
        
        //圆形图标直径为单元格高度的3/4
        let diameter = super.frame.height / 4 * 3
        //设置图标的尺寸、位置
        headImageView.frame.size = CGSize(width: diameter, height: diameter)
        headImageView.center = CGPoint(x:diameter, y: super.frame.height / 2)
        //设置圆角半径(宽度的一半)，显示成圆形。
        headImageView.layer.cornerRadius = diameter / 2
        
        //设置输入框的尺寸和位置
        textField.frame = CGRect(x: diameter * 2, y: 0,
                                 width: super.frame.width - diameter * 2,
                                 height: super.frame.height)
    }

    //输入框内容编辑
    internal func editingChanged(_ sender: UITextField) {
        guard let text = sender.text, text.characters.count > 0
            else { rowDescriptor?.value = nil; update(); return }
        rowDescriptor?.value = text as AnyObject
    }
}

3，测试代码

import UIKit
import SwiftForms

class MyFormViewController: FormViewController {
    
    override func viewDidLoad() {
        super.viewDidLoad()
        
        self.title = "hangge.com"
        
        //创建form实例
        let form = FormDescriptor()
        form.title = "Example form"
        
        //第一个section分区
        let section1 = FormSectionDescriptor(headerTitle: nil, footerTitle: nil)
        
        //第1个单元格
        var row = FormRowDescriptor(tag: "windows", type: .unknown, title: "Windows")
        row.configuration.cell.appearance["headImageView.image"] =
            UIImage(named: "windows.png") as AnyObject
        row.configuration.cell.cellClass = MyImageHeadCell.self
        section1.rows.append(row)
        
        //第2个单元格
        row = FormRowDescriptor(tag: "ruby", type: .unknown, title: "Ruby")
        row.configuration.cell.appearance["headImageView.image"] =
            UIImage(named: "ruby.png") as AnyObject
        row.configuration.cell.cellClass = MyImageHeadCell.self
        section1.rows.append(row)
        
        
        //第二个section分区
        let section2 = FormSectionDescriptor(headerTitle: nil, footerTitle: nil)
        //提交按钮
        row = FormRowDescriptor(tag: "button", type: .button, title: "提交")
        row.configuration.button.didSelectClosure = { _ in
            self.submit()
        }
        section2.rows.append(row)
        
        //将两个分区添加到form中
        form.sections = [section1, section2]
        self.form = form
    }
    
    //登录按钮点击
    func submit() {
        //取消当前编辑状态
        self.view.endEditing(true)
        
        //将表单中输入的内容打印出来
        let message = self.form.formValues().description
        print(message)
    }
    
    override func didReceiveMemoryWarning() {
        super.didReceiveMemoryWarning()
    }
}

六、创建自定义的选择控制器（Selector Controllers）