iOS開發(fā)之XLForm的使用方法
在iOS開發(fā)中,開發(fā)"表單"界面,字段稍微多一點(diǎn)的一般都用UITableView來(lái)做,而XLForm就是這樣一個(gè)框架,它是創(chuàng)建動(dòng)態(tài)表格視圖最牛逼的iOS庫(kù), 用它實(shí)現(xiàn)表單功能,非常簡(jiǎn)單,省心省力。但是很可惜,搜索了很多文章都只是翻譯官方文檔,很多人在使用該庫(kù)的時(shí)候可能都被官方文檔帶走遠(yuǎn)了,不知道如何具體使用。正好最近也要用到這個(gè)庫(kù),所以寫個(gè)入門使用文章供大家參考。
一、 導(dǎo)入項(xiàng)目
使用CocoaPods或者手動(dòng)導(dǎo)入庫(kù)文件,本人選擇直接導(dǎo)入項(xiàng)目源文件的方式。
導(dǎo)入項(xiàng)目.png
二、改造表單ViewController
讓ViewController繼承自XLFormViewController,并重寫下面的兩個(gè)方法
@interface OneViewController : XLFormViewController @end @implementation OneViewController - (instancetype)initWithNibName:(NSString *)nibNameOrNil bundle:(NSBundle *)nibBundleOrNil { self = [super initWithNibName:nibNameOrNil bundle:nibBundleOrNil]; if (self){ [self initializeForm]; } return self; } - (id)initWithCoder:(NSCoder *)aDecoder { self = [super initWithCoder:aDecoder]; if (self){ [self initializeForm]; } return self; } @end
三、構(gòu)造表單
- (void)initializeForm { // 設(shè)置是否顯示Cell之間分界線 //self.tableView.separatorStyle = UITableViewCellSeparatorStyleNone; // 設(shè)置Section的高度 self.tableView.sectionHeaderHeight = 30; XLFormDescriptor * form;//form,一個(gè)表單只有一個(gè) XLFormSectionDescriptor * section;//section,一個(gè)表單可能有多個(gè) XLFormRowDescriptor * row; //row,每個(gè)section可能有多個(gè)row // Form form = [XLFormDescriptor formDescriptor]; // First section section = [XLFormSectionDescriptor formSection]; section.title = @"用戶"; [form addFormSection:section]; // 普通文本 row = [XLFormRowDescriptor formRowDescriptorWithTag:@"username" rowType:XLFormRowDescriptorTypeText]; // 設(shè)置placeholder [row.cellConfig setObject:@"用戶名" forKey:@"textField.placeholder"]; // 設(shè)置文本顏色 [row.cellConfig setObject:[UIColor redColor] forKey:@"textField.textColor"]; [section addFormRow:row]; // 密碼 row = [XLFormRowDescriptor formRowDescriptorWithTag:@"password" rowType:XLFormRowDescriptorTypePassword]; // 設(shè)置placeholder的顏色 NSAttributedString *attrString = [[NSAttributedString alloc] initWithString:@"密碼" attributes: @{NSForegroundColorAttributeName:[UIColor greenColor], }]; [row.cellConfig setObject:attrString forKey:@"textField.attributedPlaceholder"]; [section addFormRow:row]; // Second Section section = [XLFormSectionDescriptor formSection]; section.title = @"日期"; [form addFormSection:section]; // 日期選擇器 row = [XLFormRowDescriptor formRowDescriptorWithTag:@"birthday" rowType:XLFormRowDescriptorTypeDate title:@"出生日期"]; row.value = [NSDate dateWithTimeIntervalSinceNow:60*60*24]; [section addFormRow:row]; // Third Section section = [XLFormSectionDescriptor formSection]; section.title = @"頭像"; [form addFormSection:section]; // 圖片選擇 row = [XLFormRowDescriptor formRowDescriptorWithTag:@"userpic" rowType:XLFormRowDescriptorTypeImage]; [section addFormRow:row]; // Fourth Section section = [XLFormSectionDescriptor formSection]; section.title = @"選擇器"; [form addFormSection:section]; // 選擇器 row = [XLFormRowDescriptor formRowDescriptorWithTag:@"sex" rowType:XLFormRowDescriptorTypeSelectorPush]; row.noValueDisplayText = @"暫無(wú)"; row.selectorTitle = @"性別選擇"; row.selectorOptions = @[@"男",@"女",@"其他"]; row.title = @"性別"; [row.cellConfigForSelector setObject:[UIColor redColor] forKey:@"textLabel.textColor"]; [row.cellConfigForSelector setObject:[UIColor greenColor] forKey:@"detailTextLabel.textColor"]; [section addFormRow:row]; // Fifth Section section = [XLFormSectionDescriptor formSection]; section.title = @"加固"; [form addFormSection:section]; // 開關(guān) row = [XLFormRowDescriptor formRowDescriptorWithTag:@"enforce" rowType:XLFormRowDescriptorTypeBooleanSwitch title:@"加固"]; [section addFormRow:row]; // Sixth Section section = [XLFormSectionDescriptor formSection]; [form addFormSection:section]; // 按鈕 row = [XLFormRowDescriptor formRowDescriptorWithTag:@"conform" rowType:XLFormRowDescriptorTypeButton]; row.title = @"確定"; [section addFormRow:row]; self.form = form; } -(void)didSelectFormRow:(XLFormRowDescriptor *)formRow{ // 判斷是不是點(diǎn)擊了確定按鈕 if([formRow.tag isEqualToString:@"conform"] && formRow.rowType == XLFormRowDescriptorTypeButton){ //獲取表單所有到的值 NSDictionary *values = [self formValues]; NSLog(@"%@", values); } [super didSelectFormRow:formRow]; } //重寫改該方法 上面的方法就不會(huì)調(diào)用了 //-(void)tableView:(UITableView *)tableView didSelectRowAtIndexPath:(NSIndexPath *)indexPath{ // // NSLog(@"%s", __func__); // //} @end
四、效果圖
效果圖.png
五、總結(jié)
前面兩步是官方文檔中可以找到的,也很簡(jiǎn)單,關(guān)鍵在于initializeForm方法中具體構(gòu)造表單的過(guò)程,這里有必要強(qiáng)調(diào)幾點(diǎn):
1.XLFormViewController實(shí)現(xiàn)了UITableViewDataSource, UITableViewDelegate,并且持有一個(gè)UITableView,這個(gè)從該類的聲明可以看出來(lái),所以UITableView 、UITableViewDataSource, UITableViewDelegate中的方法都可以正常使用。
2.XLForm將表單抽象為Form,Section,Row三個(gè)層次,分別對(duì)應(yīng)三個(gè)類
XLFormDescriptor * form;//form,一個(gè)表單只有一個(gè) XLFormSectionDescriptor * section;//section,一個(gè)表單可能有多個(gè) XLFormRowDescriptor * row; //row,每個(gè)section可能有多個(gè)row
3.每個(gè)表單中的具體信息最后都落腳到XLFormRowDescriptor中,通過(guò)它可以配置不同樣式的表單項(xiàng),通過(guò)構(gòu)造函數(shù)的rowType指定具體的表單類型,該框架提供了非常豐富的rowType,具體可以參考官方文檔說(shuō)明。
4.更細(xì)化配置表單項(xiàng)就需要借助于XLFormRowDescriptor中的屬性進(jìn)行配置,常用的有
@property (nonatomic, readonly, nonnull) NSMutableDictionary * cellConfig; @property (nonatomic, readonly, nonnull) NSMutableDictionary * cellConfigForSelector;
這個(gè)配置的時(shí)候,往往有同學(xué)不知道具體如何才能設(shè)置屬性,比如怎么設(shè)置表單輸入框的placeholder?更進(jìn)一步如何設(shè)置placeholder 的顏色。其實(shí)它用到了KVC,因?yàn)樗鼈儍蓚€(gè)都是UITextField類中的屬性,那么直接進(jìn)入U(xiǎn)ITextField查找,發(fā)現(xiàn)如下信息:
@property(nullable, nonatomic,copy) NSString *placeholder; @property(nullable, nonatomic,copy) NSAttributedString *attributedPlaceholder NS_AVAILABLE_IOS(6_0);
那么設(shè)置起來(lái)就是
[row.cellConfig setObject:@"用戶名" forKey:@"textField.placeholder"]; [row.cellConfig setObject:attrString forKey:@"textField.attributedPlaceholder"];
注意這里的key的寫法,就是KVC的寫法。其他的屬性依此類推。
5.如何獲取設(shè)置好的表單的值?其實(shí)非常簡(jiǎn)單,該框架提供一個(gè)方法formValues,它的返回類型是一個(gè)NSDictionary,其中key就是XLFormRowDescriptor設(shè)置時(shí)的Tag??梢灾苯釉诳刂破髦姓{(diào)用該方法獲取表單值,上面的效果圖設(shè)置后的表單信息如下:
以上就是本文的全部?jī)?nèi)容,希望對(duì)大家的學(xué)習(xí)有所幫助,也希望大家多多支持腳本之家。
相關(guān)文章
iOS App使用SQLite之句柄的定義及數(shù)據(jù)庫(kù)的基本操作
SQLite中在定義過(guò)句柄之后就可以指向數(shù)據(jù)庫(kù),從而利用iOS應(yīng)用程序進(jìn)行打開或關(guān)閉等各種操作,這里我們就來(lái)看一下iOS App使用SQLite之句柄的定義及數(shù)據(jù)庫(kù)的基本操作2016-06-06iOS應(yīng)用中使用Toolbar工具欄方式切換視圖的方法詳解
這篇文章主要介紹了iOS應(yīng)用中使用Toolbar工具欄方式切換視圖的方法,文中講解了UIToolbar的相關(guān)編寫以及使用xib方式創(chuàng)建可切換視圖程序的例子,需要的朋友可以參考下2016-04-04iOS下拉刷新 UIScrollVie異常閃動(dòng)問(wèn)題
這篇文章主要介紹了iOS下拉刷新 UIScrollVie異常閃動(dòng)問(wèn)題,非常不錯(cuò),具有參考借鑒價(jià)值,需要的朋友可以參考下2017-03-03詳解iOS游戲開發(fā)中Cocos2D的坐標(biāo)位置關(guān)系
這篇文章主要介紹了iOS游戲開發(fā)中Cocos2D的坐標(biāo)位置關(guān)系,Cocos2D是專門用來(lái)開發(fā)iOS游戲的開源框架,文中示例代碼采用Objective-C語(yǔ)言,需要的朋友可以參考下2016-02-02iOS的CoreAnimation開發(fā)框架中的Layer層動(dòng)畫制作解析
在iOS中UIView層的屬性會(huì)映射到CoreAnimation框架的CALayer,這里我們來(lái)看一下iOS的CoreAnimation開發(fā)框架中的Layer層動(dòng)畫制作解析,需要的朋友可以參考下2016-07-07總結(jié)iOS App開發(fā)中控制屏幕旋轉(zhuǎn)的幾種方式
這篇文章主要介紹了iOS app開發(fā)中控制屏幕旋轉(zhuǎn)的方法總結(jié),分為自動(dòng)旋轉(zhuǎn)和手動(dòng)旋轉(zhuǎn)以及強(qiáng)制旋轉(zhuǎn)三種情況,代碼為Objective-C語(yǔ)言,需要的朋友可以參考下2016-02-02簡(jiǎn)單說(shuō)說(shuō)iOS之WKWebView的用法小結(jié)
iOS8.0之后我們使用 WebKit框架中的WKWebView來(lái)加載網(wǎng)頁(yè)。這篇文章主要介紹了簡(jiǎn)單說(shuō)說(shuō)iOS之WKWebView的用法小結(jié),小編覺(jué)得挺不錯(cuò)的,現(xiàn)在分享給大家,也給大家做個(gè)參考。一起跟隨小編過(guò)來(lái)看看吧2019-01-01