iOS邮箱模糊匹配功能集成

作者: 小怡情ifelse | 来源:发表于2016-08-24 17:43 被阅读867次

    大家有些人应该遇到产品汪提过这样的需求,产品汪说:“某某App的订单填写页,输入用户邮箱有个提示邮箱后缀的功能,很好用啊!还可以根据各个邮箱类型用户量来做一个优先级的匹配哦。你可以不可以帮我实现哎!”这个做起来确实很烦的,产品汪是男的还可以拒绝掉,人家有啥功能你就做啥功能啊?但是如果是个漂亮的女产品汪,娇滴滴的来和你说~这个时候你能扛得住么?一不小心掉坑里了,答应了,一时爽快了。但是码代码就很蛋疼了,别怕,有我在,已经用一个自定义的textField全部集成好了~先看效果图。


    邮箱匹配效果图.gif

    一.介绍一下功能

    当输入一个邮箱的数字,会默认在后面匹配出来@qq.com,当然这个默认@qq.com可以换成其他的如@163.com等等。这里默认是@qq.com,因为我们的产品汪做过统计大多数用户还是用的qq邮箱,所以默认是@qq.com。
    当输入@符号还是不会有所变化,但是如果在@之后再输入字符,会将这个字符和你想要提示的邮箱后缀做匹配,我这里是需要匹配@qq.com,@163.com,@126.com,@yahoo.com,@139.com,@henu.com类型。例如:在@之后你输入了1,这个时候会在@1之后匹配出来63.com。接着,当你在@1之后又输入了2,会在@12后面匹配出来6.com。这些匹配的优先级是根据你给的需要匹配邮箱类型的顺序来的,并且这些想要匹配的邮箱类型也是完全可配的,可根据产品汪的需求作自己的定制。

    二.说一下用法

    1.先说一下如果你是在xib中想实现这个功能,首先要拖拽一个textField,设置好约束,然后让这个textField的类关联到XLTextField,当前前提你要下载并导入了XLTextField.h和XLTextField.m,切记不要忘了将textField.delegate设置给viewController,textField样式可在xib自行设置,匹配的邮箱区域颜色可自行设置,然后在代码中只需要调API

    /**
    *
    *1.通过xib创建只需要赋值此参数即可
    *@param mailTypeArray邮箱匹配类型
    *
    */
    @property(nonatomic,strong)NSMutableArray*mailTypeArray;
    

    示例代码:

    self.textField.mailTypeArray= [NSMutableArrayarrayWithObjects:@"@qq.com",@"@163.com",@"@126.com",@"@yahoo.com",@"@139.com",@"@henu.com",nil];
    self.textField.didPressedReturnCompletion = ^(UITextField * textField){
          //点击return的回调,是可选的 根据自己需求使用
    };
    

    XLTextField.h还提供了一个可选的mailMatchColor属性这个属性是UIColor类型的,是匹配邮箱类型的颜色,可根据需求自行设置。

    /**
    *Optional匹配的邮箱类型后缀默认是RGB为170 170 170的颜色,可自行设置
    */
    @property(nonatomic,strong)UIColor* mailMatchColor;
    

    2.通过手动frame创建两个基本参数设置大小和字号,其他设置可额外自行设置,调用API

    /**
    *2.通过手写创建textField时候调用
    *
    *@param frameframe大小
    *@param fontSize textField大小
    *
    *@return self
    */
    - (instancetype)initWithFrame:(CGRect)frame fontSize:(CGFloat)fontSize;
    

    示例代码:

    XLTextField * field = [[XLTextField alloc] initWithFrame:CGRectMake(100, 200, 200, 30) fontSize:12];
    field.placeholder = @"输入邮箱地址";
    field.mailTypeArray = [NSMutableArray arrayWithObjects:@"@qq.com",@"@163.com",@"@126.com",@"@yahoo.com",@"@139.com",@"@henu.com", nil];
    Field.didPressedReturnCompletion = ^(UITextField * textField){
          //点击return的回调,是可选的 根据自己需求使用
    };
    field.mailMatchColor = [UIColor redColor]; 可选属性
    [self.view addSubview:field];
    

    我在示例程序中只针对xib的textField写了手势关闭,结束textField的输入操作,手洞创建textField没有写结束第一响应者的操作。如果你在实际使用中,可以根据你的需求例如点击键盘的完成按钮,或者触摸屏幕的View等场景下结束textField的键盘第一响应者,从而取textField的text进行额外的需求操作。
    可根据自己需求定制自己的frame,font大小。不过不支持init和new初始化方法,即使用了也没关系,会有一个温馨的报错提示

    - (instancetype)init__attribute__((unavailable("init方法不可用,请用initWithName:fontSzie:")));
    + (instancetype)new__attribute__((unavailable("init方法不可用,请用initWithName:fontSzie:")));
    

    更新版本内容:

    如果接入的类需要在textField的代理方法中做操作 可实现对应的协议即可
    @protocol XLEmailTextFieldDelegate <NSObject>
    
    @optional
    - (BOOL)XLTextFieldShouldBeginEditing:(UITextField *)textField;
    - (void)XLTextFieldDidBeginEditing:(UITextField *)textField;
    - (void)XLTextFieldDidEndEditing:(UITextField *)textField;
    - (BOOL)XLTextField:(UITextField *)textField shouldChangeCharactersInRange:(NSRange)range replacementString:(NSString *)string;
    - (BOOL)XLTextFieldShouldReturn:(UITextField *)textField;
    
    @end
    

    三.介绍一下实现原理

    1.可能你不看源码,就认为是一个textField实现了全部功能,其实No.我这里是配合了一个Label,在xib实现时利用aulayout手动添加Label。textField只是用来让用户输入,Label用来存储匹配之后的邮箱(邮箱号码+邮箱类型),并且展示。你看到的其实是Label的text内容。当最后结束编辑的时候,Label会将内容复制给textField的text,然后清空Label。Label只是在这里提一下实现方式,真正使用的值还是通过textField.text拿到的值。在这里你可能会吐槽,为什么不用一个textField呢,多简单省事。但是事实是我尝试过一个textField,中间遇到了一个坑,好像是textField一个bug,暂且这样说 因为当时确实是很奇葩的问题,具体是那么也忘记了,这里也不展开说了,有兴趣你可以用一个textField来尝试一下哈。

    2.textField的代理方法全部封装在textField.m内部,在内部已经处理了这些代理,更加方便他人调用,不用再花很多心思在调试textField的代理方法上。不论是用xib还是用手动代码创建,都不需要设置textField.delegate给控制器。

    3.在textField的shouldChangeCharactersInRange代理方法中针对你输入的每一个字符进行邮箱的匹配,下面会有这一块的完整代码。在textFieldDidEndEditing代理方法中将Label的值赋值给textField.text,然后将Label.text清空,直接取textField.text作为我们最终的结果。

    下面贴上匹配邮箱过程的关键代码,并且每行都有注释,如果想要看更多源码欢迎在点击下载源码,查看所有源码。

    /**
    *匹配邮箱过程
    *
    *@param rangerange
    *@param string用户输入string
    */
    
    - (void)configMailMatchingRange:(NSRange)range replacementString:(NSString*)string
    {
    //获取完整的输入文本
    NSString*completeStr = [self.textstringByReplacingCharactersInRange:rangewithString:string];
    
    //以@符号分割文本
    NSArray*temailArray = [completeStrcomponentsSeparatedByString:@"@"];
    
    //获取邮箱前缀
    NSString*emailString = [temailArrayfirstObject];
    
    //邮箱匹配没有输入@符号时用@匹配
    NSString*matchString =@"@";
    if(temailArray.count>1){
    //如果已经输入@符号截取@符号以后的字符串作为匹配字符串
    matchString = [completeStrsubstringFromIndex:emailString.length];
    }
    
    //匹配邮箱得到所有跟当前输入匹配的邮箱后缀
    NSMutableArray*suffixArray = [selfcheckEmailStr:matchString];
    
    //边界控制如果没有跟当前输入匹配的后缀置为@""
    NSString*fixStr = suffixArray.count>0? [suffixArrayfirstObject] :@"";
    
    //将lblEmail部分字段隐藏
    NSIntegercutLenth = suffixArray.count>0? completeStr.length: emailString.length;
    
    //最终的邮箱地址
    self.email= fixStr.length>0? [NSStringstringWithFormat:@"%@%@",emailString,fixStr] : completeStr;
    
    //设置lblEmail的attribute
    NSMutableAttributedString*attributeString = [[NSMutableAttributedStringalloc]initWithString:[NSStringstringWithFormat:@"%@%@",emailString,fixStr]];
    
    [attributeStringaddAttribute:NSForegroundColorAttributeNamevalue:[UIColorclearColor]range:NSMakeRange(0,cutLenth)];
    
    self.mailLabel.attributedText= attributeString;
    
    //清空文本框内容时隐藏lblEmail
    if(completeStr.length==0){
    self.mailLabel.text=@"";
    self.email=@"";
    }
    }
    
    

    更新了文件,因为今天我在实际项目中又用到了邮箱匹配,不过因为是老项目,原来的基础上已经实现了textField的代理方法,并且有一些额外的操作,这个时候因为此textField代理是自己,所以代理方法是私有的,为了不影响之前的老代码,特意对外开放了textField的代理方法,也算是适配器模式的一种场景,改变接口即可复用老代码。可根据
    自身需要去实现customDelegate。
    如果你还喜欢,请留下一个Star,在这里先说声谢谢啦😍~
    本人水平有限,如有纰漏指出欢迎指正!
    如果您在使用中 有不能满足的需求~可以提出来 我做修改 尽量满足大家的需求。
    在这里要感谢下@QYunFat,给的好的建议在点击return赋值textField,当时没考虑到这个,已添加😆
    iOS 开发技术交流群号:529560119 ,提供各种最新权威学习书籍及开发视频

    相关文章

      网友评论

        本文标题:iOS邮箱模糊匹配功能集成

        本文链接:https://www.haomeiwen.com/subject/bddosttx.html