FXForms,自动生成iOS表单

1.简介

FXForms是一个简单的表单提交框架,他的作者是鼎鼎大名的 Nick Lockwood,你也许听说过他的其他的一些框架,比如 iCarousel.

为什么使用FxForms?

  1. 表单处理简单化,使开发者能轻松上手
  2. 表单自适应不同屏幕

FXForms是怎么工作的?

Fields will automatically be assigned suitable control types, for example, the rememberMe field will be displayed as a UISwitch, the email field will automatically have a keyboard of type UIKeyboardTypeEmailAddress and the password field will automatically have secureTextEntry enabled.

根据它的官方解释,FXForms上面的每一个元素是根据类型来自动生成的,比如 NSString 会自动生成一个 UITextField. UIDate 会自动生成一个DateTime Picker等等。

项目主页:https://github.com/nicklockwood/FXForms

项目的本身自带了很好的例子,在此不再重复。示例工程给出一个入门的例子,能够帮助大家快速上手。

示例工程:https://github.com/ios122/ios122

2.安装

安装的方式通常有两种,Cocopods, 源代码安装。后一种安装方式很直观,只需要把相应的 FXForms.h 和 FXForms.m拖到项目中即可。这里我们简单介绍一下cocopods的安装:

Step 1. 新建一个iOS工程,在工程根目录下新建一个文件 Podfile, 内容如下:

pod 'FXForms'

Step 2. Run:

pod update --verbose --no-repo-update

~安装完毕, 请打开xcworkspace,示例中是 FXFormsTutorial.xcworkspace

3. 基本的使用规则

这里我们使用一个最常见的例子:登录。

Example : 登录View

Step 1, 生成一个新的类,使这个类继承 NSObject,同时 Delegate FXForm, 代码如下:

LoginFXForm.h

//
//  LoginFXForm.h
//  FXFormsTutorial
//
//  Created by arkilis on 28/11/2015.
//  Copyright © 2015 arkilis. All rights reserved.
//

#import <UIKit/UIKit.h>
#import "FXForms.h"

@interface LoginFXForm : NSObject <FXForm>

@property (nonatomic, copy)     NSString        *email;
@property (nonatomic, copy)     NSString        *password;

@end

LoginFXForm.m

#import "LoginFXForm.h"

@implementation LoginFXForm



// 定制 Form

// -- username
- (NSDictionary *)emailField{
    return @{
             FXFormFieldHeader:         @"Login",       // Form Title
             FXFormFieldKey:            @"email",       // 对应的 key
             FXFormFieldTitle:          @"Email",       // 字段的 Title
             };
}
// -- password
- (NSDictionary *)passField {
    return @{
             FXFormFieldKey:            @"password",    // 这里如果FXForm知道这里用的是密码,则自动屏蔽密码,用星标代替
             FXFormFieldTitle:          @"password",
             };
}


// Submit button and return button
- (NSArray *)extraFields
{
    return @[
             // 这里你不用在头文件里声明, 只需要在返回的 NSArray中添加一个元素即可
             @{FXFormFieldTitle: @"Submit", FXFormFieldHeader: @"", FXFormFieldAction: @"submitLoginForm:"},
             @{FXFormFieldTitle: @"Return", FXFormFieldHeader: @"", FXFormFieldAction: @"returnPreviousView"},
             ];
}

@end

在注释中,我做了一些详细的解释。

4. 一些技巧

  1. 有的时候我们需要给字段设定一些默认值,比如Email。我们可以设置字段 FXFormFieldDefaultValue:
// -- username
- (NSDictionary *)emailField{
    return @{
             FXFormFieldHeader:         @"Login",       // Form Title
             FXFormFieldKey:            @"email",       // 对应的 key
             FXFormFieldTitle:          @"Email",       // 字段的 Title
             FXFormFieldDefaultValue:   @"Your Email"   // 字段的预留信息  <--
             };
}

注意这个option跟FXFormFieldPlaceholder是不一样的,FXFormFieldPlaceholder仍能让你输入,而FXFormFieldDefaultValue是默认值

  1. 设置只读, 有些时候我们要设置一些表单字段为只读。
// -- username
- (NSDictionary *)emailField{
    return @{
             FXFormFieldHeader:         @"Login",       // Form Title
             FXFormFieldKey:            @"email",       // 对应的 key
             FXFormFieldTitle:          @"Email",       // 字段的 Title
             FXFormFieldPlaceholder:    @"Your Email",  // 字段的预留信息
             @"textField.enabled":      @(NO)           // set readonly
             };
}

5. 联系我

如有什么问题,可以联系我: arkilis#gmail.com

注: 文章由我们 iOS122 的小伙伴 **@Arkilis** 整理,喜欢就一起参与: iOS122 任务池

本文参与腾讯云自媒体分享计划,欢迎正在阅读的你也加入,一起分享。

发表于

我来说两句

0 条评论
登录 后参与评论

相关文章

来自专栏数据之美

Fiddler 高级用法:Fiddler Script 与 HTTP 断点调试

之前在《关于 WEB/HTTP 调试利器 Fiddler 的一些技巧分享》中系统的介绍过 Fiddler 的原理与一些常见技巧,但那篇文章只是入门科普,并不深入...

92680
来自专栏一“技”之长

NSAlert组件应用总结 原

    在桌面软件开发中,当用户进行非法的操作或有风险的操作时,时长需要弹出警告框来提示用户。在OS X系统上,NSAlert是专门的警告框组件。其提供了简洁的...

12240
来自专栏阿炬.NET

ASP.NET MVC 4 中Jquery上传插件Uploadify简单使用-版本:3.2.1

33850
来自专栏Golang语言社区

剖析Go编写的Socket服务器模块解耦及基础模块的设计

Server的解耦—通过Router+Controller实现逻辑分发 在实际的系统项目工程中中,我们在写代码的时候要尽量避免不必要的耦合,否则你以后在更新和维...

38140
来自专栏一个会写诗的程序员的博客

bootstrap-table 前端分页,刷新事件代码实例

参考文档: http://bootstrap-table.wenzhixin.net.cn/

1.3K10
来自专栏hbbliyong

WPF命令(Command)介绍、命令和数据绑定集成应用

要开始使用命令,必须做三件事:                                               一:定义一个命令       ...

58130
来自专栏青青天空树

nodejs构建多房间简易聊天室

  本服务器需要提供两个功能:http服务和websocket服务,由于node的事件驱动机制,可将两种服务搭建在同一个端口下。

35610
来自专栏iOS技术杂谈

NSNotificationCenter 通知的使用方法详解你要知道的KVC、KVO、Delegate、Notification都在这里

你要知道的KVC、KVO、Delegate、Notification都在这里 转载请注明出处 https://cloud.tencent.com/develop...

52460
来自专栏mukekeheart的iOS之旅

iOS学习——键盘弹出遮挡输入框问题解决方案

  在iOS或Android等移动端开发过程中,经常遇到很多需要我们输入信息的情况,例如登录时要输入账号密码、查询时要输入查询信息、注册或申请时需要填写一些信息...

57560
来自专栏君赏技术博客

UIBarButtonItem我用了这些姿势才能和你交互

因为系统是没有方式可以获取到 Done 按钮的,我们运用运行时倒是可以获取到这个按钮。

27050

扫码关注云+社区

领取腾讯云代金券