SHSPhoneComponents—— 格式化显示输入手机号码

一个可以格式化显示手机号码的组件

• GitHub 地址：Serheo/SHSPhoneComponents
• star: 300+

用于格式化显示电话号码的 UITextField 和 NSFormatter 子类。 允许不同国家（模式）的不同格式。

插图定位工作出色。

Swift 版本点击此处：https://github.com/Serheo/PhoneNumberFormatter

如何安装

使用以下任意方法：

• 使用嵌入式框架 /SHSPhoneComponents/SHSPhoneComponent.xcodeproj (iOS 8+)
• pod 'SHSPhoneComponent'
• 复制 /SHSPhoneComponents/Library 文件夹到项目中。

并且在视图控制器中 import "SHSPhoneLibrary.h"。

使用示例

如果你需要完整的示例，请查看 ‘Example_iOS7+’ 【Objective-C 版】 或者 ‘Example_iOS8+embedded’ 【Swift 版】文件夹。

设置默认格式

[self.phoneField.formatter setDefaultOutputPattern:@"+# (###) ###-##-##"];

所有输入字符串将以此方式进行解析。
例如: +7 (920) 123-45-67

⚠️ 注意，不仅仅是显示时格式化手机号码，self.phoneField.text 获取到的手机号码也是被格式化的。

前缀格式

你可以为所有的输入设置前缀：

[self.phoneField.formatter setDefaultOutputPattern:@"(###) ###-##-##"];
self.phoneField.formatter.prefix = @"+7 ";  // 初始化默认带 “+7” 前缀，用户无法删除

多格式支持

// 默认格式
[self.phoneField.formatter setDefaultOutputPattern:@"##########" imagePath:nil];

// 7开头格式 
[self.phoneField.formatter addOutputPattern:@"+# (###) ###-##-##" forRegExp:@"^7[0-689]\\d*$" imagePath:@"flagRU"];

// 374开头格式 
[self.phoneField.formatter addOutputPattern:@"+### (##) ###-###" forRegExp:@"^374\\d*$" imagePath:@"flagAM"];

多格式支持并且带前缀

[self.phoneField.formatter setDefaultOutputPattern:@"### ### ###"];
self.phoneField.formatter.prefix = @"+7 ";
[self.phoneField.formatter addOutputPattern:@"(###) ###-##-##" forRegExp:@"^1\\d*$" imagePath:@"SHSPhoneImage.bundle/flag_ru"];
[self.phoneField.formatter addOutputPattern:@"(###) ###-###" forRegExp:@"^2\\d*$" imagePath:@"SHSPhoneImage.bundle/flag_ua"];

指定格式

如果你想格式化一些数字的具体方式只要做

[self.phoneField.formatter addOutputPattern:@"+# (###) ###-##-##" forRegExp:@"^7[0-689]\\d*$" imagePath:@"flagRU"];
[self.phoneField.formatter addOutputPattern:@"+### (##) ###-###" forRegExp:@"^374\\d*$" imagePath:@"flagAM"];

配合 XLForm 框架使用示例

// 联系电话
row = [XLFormRowDescriptor formRowDescriptorWithTag:@"KPhoneNumber" rowType:XLFormRowDescriptorTypePhone title:@"联系电话"];
[row.cellConfigAtConfigure setObject:@(NSTextAlignmentRight) forKey:@"textField.textAlignment"];
row.value = self.formModel.phoneNumber;
[row.cellConfig setObject:@"请输入手机号码" forKey:@"textField.placeholder"];
row.required = YES;
[row addValidator:[XLFormRegexValidator formRegexValidatorWithMsg:@"手机号码格式错误" regex:@"^1(3|4|5|6|7|8|9)\\d{9}$"]];

// 格式化显示（仅限手机号码使用）
SHSPhoneNumberFormatter *formatter = [[SHSPhoneNumberFormatter alloc] init];
[formatter setDefaultOutputPattern:@"### #### ####"];
row.valueFormatter = formatter;
row.useValueFormatterDuringInput = YES; // 仅在输入时显示格式化格式
[section addFormRow:row];

格式化功能

如果您只需要格式化功能，可以使用 SHSPhoneNumberFormatter 类。
For additional class info see http://serheo.github.io/SHSPhoneComponent/

Issues and Solutions

if you are using any predictions/suggestion in the textfield, set hasPredictiveInput flag to YES.

Requirements

ARC Enabled.
iOS 7+

许可证

SHSPhoneComponent is available under the MIT license. See the LICENSE file for more info.

设置格式化的方法都在 SHSPhoneNumberFormatter+UserConfig.h 分类中

-(void) resetDefaultFormat;
-(void) resetFormats;

-(void) setDefaultOutputPattern:(NSString *)pattern imagePath:(NSString *)imagePath;
-(void) setDefaultOutputPattern:(NSString *)pattern;

-(void) addOutputPattern:(NSString *)pattern forRegExp:(NSString *)regexp imagePath:(NSString *)imagePath;
-(void) addOutputPattern:(NSString *)pattern forRegExp:(NSString *)regexp;

-(void) setOutputPatternsFromArray:(NSArray *)patterns;