THContactPicker 2.0

THContactPicker 2.0

测试已测试
Lang语言 Obj-CObjective C
许可证 MIT
Released最后发布2016年1月

Tristan Himmelman 维护。



  • Tristan Himmelman

THContactPicker 是一个 iOS 视图,用于选择联系人。它被构建来模拟 iOS 邮件应用中的联系人选择功能。它还支持针对不同样式要求的自定义。

Screenshot Screenshot

安装

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;

Screenshot