测试已测试 | ✗ |
Lang语言 | Obj-CObjective C |
许可证 | MIT |
Released最后发布 | 2016年1月 |
由 Tristan Himmelman 维护。
THContactPicker 是一个 iOS 视图,用于选择联系人。它被构建来模拟 iOS 邮件应用中的联系人选择功能。它还支持针对不同样式要求的自定义。
THContactPicker 可以通过手动添加到您的项目中或使用 Cocoapods
pod 'THContactPicker', '~> 1.2'
可以使用界面构建器或编程方式添加视图。以下是通过编程方式添加它的示例
self.contactPickerView = [[THContactPickerView alloc] initWithFrame:CGRectMake(0, 0, self.view.frame.size.width, 100)];
[self.contactPickerView setPlaceholderLabelText:@"Who would you like to message?"];
self.contactPickerView.delegate = self;
[self.view addSubview:self.contactPickerView];
通过这两个函数将联系人添加到视图或从视图中删除
- (void)addContact:(id)contact withName:(NSString *)name;
- (void)removeContact:(id)contact;
THContactPickerView 定义以下委托协议,使您的视图能够轻松响应对任何更改
@protocol THContactPickerDelegate <NSObject>
@optional
- (void)contactPickerDidResize:(THContactPickerView *)contactPicker;
- (void)contactPicker:(THContactPickerView *)contactPicker didSelectContact:(id)contact;
- (void)contactPicker:(THContactPickerView *)contactPicker didRemoveContact:(id)contact;
- (void)contactPicker:(THContactPickerView *)contactPicker textFieldDidBeginEditing:(UITextField *)textField;
- (void)contactPicker:(THContactPickerView *)contactPicker textFieldDidEndEditing:(UITextField *)textField;
- (BOOL)contactPicker:(THContactPickerView *)contactPicker textFieldShouldReturn:(UITextField *)textField;
- (void)contactPicker:(THContactPickerView *)contactPicker textFieldDidChange:(UITextField *)textField;
@end
设置在视图中没有选中联系人时显示的文本
- (void)setPlaceholderLabelText:(NSString *)text;
设置先行提示标签的文本。如果未设置,则不会显示标签
- (void)setPromptLabelText:(NSString *)text;
更改视图中所有元素的字体
- (void)setFont:(UIFont *)font;
设置联系人的默认和选中状态的样式
- (void)setContactViewStyle:(THContactViewStyle *)color selectedStyle:(THContactViewStyle *)selectedColor;
THContactViewStyle 定义每个联系人项的外观。以下属性可以修改:文本标签颜色、顶部渐变颜色、底部渐变颜色、边框颜色、边框宽度以及圆角半径系数。例如:[查看截图](https://raw.githubusercontent.com/tristanhimmelman/THContactPicker/master/bubbleStyle.png)
您还可以为每个联系人视图设置不同的样式
- (void)addContact:(id)contact withName:(NSString *)name withStyle:(THContactViewStyle *)bubbleStyle andSelectedStyle:(THContactViewStyle *)selectedStyle;