制作一个微博文本编辑器

本文章的Demo工程

最近需要制作一个类似发微博的界面,支持“@用户”以及“#话题#”等格式高亮,并且可输入展示自定义表情图片。期间写了个demo,截图如下:

demo.png

首先关于这种富文本展示就不造轮子了,直接使用了YYText ,可以省不少时间。

1 分析

首先效果大体效仿微博,"@用户"与"#热门话题#"并非绑定字符串,用户可以随时在其中插入编辑并高亮展示。
关于图片样式,这里随便用了几个表情作为示例,实现是利用图片替换纯文本中指定的字符串(比如“[大笑]” ),删除时图片整体删除,复制时复制对应的字符串,粘贴或者用户打出对应字符自动转换为表情图片。

首先很容易想到用正则来匹配关键字符串,转换为attribute string着色展示;利用NSTextAttachment插入图片并替换字符。如果只是展示已经足够,但如果展示之后需要再次编辑,那么实现起来会很复杂(可以想到每增删字符后都要重新匹配全文并重新赋予attribute string)。

其实在YYText的demo中实现的markdown语法解析,和本需求实现如出一辙,其实目的就是做一个“语法解析器” 。所以接下来参照YYTextSimpleMarkdownParser 自定义一个对象实现YYTextParser协议,并将对象复制给YYTextView的实例即可。

2 实现

首先创建自定义解析器并准守协议

#import <Foundation/Foundation.h>
#import "YYTextParser.h"

@interface TextParser : NSObject<YYTextParser>

@end

关于YYTextView的创建不再赘述,创建完成后赋值textParser属性

    self.textView.textParser = [[TextParser alloc]init];

接下来就该实现TextParser的.m文件了,查阅YYTextParser类发现只有一个require方法:

/**
 When text is changed in YYTextView or YYLabel, this method will be called.
 
 @param text  The original attributed string. This method may parse the text and
 change the text attributes or content.
 
 @param selectedRange  Current selected range in `text`.
 This method should correct the range if the text content is changed. If there's 
 no selected range (such as YYLabel), this value is NULL.
 
 @return If the 'text' is modified in this method, returns `YES`, otherwise returns `NO`.
 */
- (BOOL)parseText:(nullable NSMutableAttributedString *)text selectedRange:(nullable NSRangePointer)selectedRange;

这里注释已比较清楚,需要配合YYTextView/YYLabel来使用,并会在text改变的时候调用,所以在这个方法里面对文本进行解析再合适不过了。

首先在此之前,需要定义对应的正则以及字体颜色等,这里说下正则这部分申明以及赋值:

 NSRegularExpression *_regexAt;
 NSRegularExpression *_regexPoundSign;

 _regexAt = [NSRegularExpression regularExpressionWithPattern:@"@[\u4e00-\u9fa5a-zA-Z0-9_-]{2,30}" options:0 error:NULL];
_regexAt = [NSRegularExpression regularExpressionWithPattern:@"#[^#]+#" options:0 error:NULL];

这里的正则匹配了@之后2~30位长度的字符,以及#之间的字符。
接下来单独处理图片相关的匹配

 NSRegularExpression *_regexImage;
 NSDictionary *_imageMapper;

这里的_imageMapper字典就是为了保存一份对应关系,就是字符与图片文件的映射,下面的代码初始化字典,然后遍历字典的key构造匹配的正则字符串,最后赋值给_regexImage,需要注意的是iOS中需要对特殊字符进行转义。

  _imageMapper = @{
                     @"[嘻嘻]" : [UIImage imageNamed:@"yb001"],
                     @"[呆]" : [UIImage imageNamed:@"yb002"],
                     @"[色]" : [UIImage imageNamed:@"yb003"]
                     };
    
    NSMutableString *pattern = @"(".mutableCopy;
    NSArray *allKeys = _imageMapper.allKeys;
    NSCharacterSet *charset = [NSCharacterSet characterSetWithCharactersInString:@"$^?+*.,#|{}[]()\\"];
    for (NSUInteger i = 0, max = allKeys.count; i < max; i++) {
        NSMutableString *one = [allKeys[i] mutableCopy];
        
        // escape regex characters
        for (NSUInteger ci = 0, cmax = one.length; ci < cmax; ci++) {
            unichar c = [one characterAtIndex:ci];
            if ([charset characterIsMember:c]) {
                [one insertString:@"\\" atIndex:ci];
                ci++;
                cmax++;
            }
        }
        
        [pattern appendString:one];
        if (i != max - 1) [pattern appendString:@"|"];
    }
    [pattern appendString:@")"];
    _regexImage = [[NSRegularExpression alloc] initWithPattern:pattern options:kNilOptions error:nil];

剩下的就是协议方法的实现了


- (BOOL)parseText:(NSMutableAttributedString *)text selectedRange:(NSRangePointer)range {
    __block BOOL changed = NO;
    
    if (text.length == 0) { return NO; }
    
    text.yy_font = _normalFont;
    text.yy_color = _normalColor;
    
    // @用户
    [_regexAt enumerateMatchesInString:text.string options:NSMatchingWithoutAnchoringBounds range:text.yy_rangeOfAll usingBlock:^(NSTextCheckingResult *result, NSMatchingFlags flags, BOOL *stop) {
        
        NSRange range = result.range;
        [text yy_setColor:_atTextColor range:range];
        changed = YES;
    }];
    
    
    // #话题#
    [_regexPoundSign enumerateMatchesInString:text.string options:NSMatchingWithoutAnchoringBounds range:text.yy_rangeOfAll usingBlock:^(NSTextCheckingResult * _Nullable result, NSMatchingFlags flags, BOOL * _Nonnull stop) {
        
        NSRange range = result.range;
        [text yy_setColor:_atTextColor range:range];
        changed = YES;
    }];
    
    // 图片
    
    if (_imageMapper.count){
        NSArray *matches = [_regexImage matchesInString:text.string options:kNilOptions range:NSMakeRange(0, text.length)];
        
        if (matches.count) {
            NSRange selectedRange = range ? *range : NSMakeRange(0, 0);
            NSUInteger cutLength = 0;
            for (NSUInteger i = 0, max = matches.count; i < max; i++) {
                NSTextCheckingResult *one = matches[i];
                NSRange oneRange = one.range;
                if (oneRange.length == 0) continue;
                oneRange.location -= cutLength;
                NSString *subStr = [text.string substringWithRange:oneRange];
                UIImage *emoticon = _imageMapper[subStr];
                if (!emoticon) continue;
                
                CGFloat fontSize = kNormalFontSize;
                CTFontRef font = (__bridge CTFontRef)([text yy_attribute:NSFontAttributeName atIndex:oneRange.location]);
                if (font) fontSize = CTFontGetSize(font);
                
                NSMutableAttributedString *atr = [NSAttributedString yy_attachmentStringWithEmojiImage:emoticon fontSize:fontSize];
                
                [atr yy_setTextBackedString:[YYTextBackedString stringWithString:subStr] range:NSMakeRange(0, atr.length)];
                [text replaceCharactersInRange:oneRange withString:atr.string];
                [text yy_removeDiscontinuousAttributesInRange:NSMakeRange(oneRange.location, atr.length)];
                [text addAttributes:atr.yy_attributes range:NSMakeRange(oneRange.location, atr.length)];
                selectedRange = [self _replaceTextInRange:oneRange withLength:atr.length selectedRange:selectedRange];
                cutLength += oneRange.length - 1;
            }
            if (range) *range = selectedRange;
            
            changed = YES;
        }
        
    }

    return changed;
}

上面有关图片的代码由于发生了文本替换会比较长,替换前后的range、光标位置等内容的重设,需要把控细节有很多,可以下载demo来看(_replaceTextInRange方法就是重新设置选择区域(光标位置) 包含在demo中)。

3 其他细节

3.1 上面的图片实现:
NSMutableAttributedString *atr = [NSAttributedString yy_attachmentStringWithEmojiImage:emoticon fontSize:fontSize];

其实这代码设置的是表情图片,其尺寸是通过传入的fontSize计算而成,倘若图片并非整套表情而是一个长宽不等的矩形图片,则需要修改下这段代码:

 NSMutableAttributedString *atr = [NSAttributedString yy_attachmentStringWithContent:emoticon contentMode:UIViewContentModeCenter attachmentSize:emoticon.size alignToFont:_normalFont alignment:YYTextVerticalAlignmentCenter];

这样就可以将不规则图片插入文本中了。

3.2 关于YYTextBackedString 默认情况下AttributedString中插入图片然后log是没有任何图片的文本信息的,复制图片后粘贴也是空字符串,但如果设置了YYTextBackedString就可以赋值文本属性给图片了。
[atr yy_setTextBackedString:[YYTextBackedString stringWithString:subStr] range:NSMakeRange(0, atr.length)];
3.3 本文为了尽量少贴不必要的代码,去掉了一些判空判断,字符串数组字典的值使用前尽量判断是否为空。
3.4有关线程安全,本文用到的存有字符与图片映射的字典_imageMapper由于非线程安全,在频繁的编辑下是容易发生同时读写的情况,假如是固定的表情自初始化完毕后不会增删就没啥问题,但非这种情况就需要声明”锁“(NSLock, 信号量等控制均可) 来防止多线程同时访问,并设置为默认的atomic属性,这里可以参照YYText中的YYTextParser.m文件有关实现。

4 To do

写本文时,其实还有一种格式需求没有搞定,如下图


image.png

微博里非常常见的一种格式,想简单些就是左边图片与“查看图片”四个字共属一图,将图片url复制给整张图片,但会造成“查看图片”四字无法折行的bug(其实算不算bug要看产品),接下来就是解决这个问题了。

Update 17-5-17 上面问题的解决

今天优化这块代码,其中上面样式也做了出来,如下图:

image&textBinding.png

其中核心实现是将图片与文字拼接成一个NSAttributedString,之后对拼接结果进行binding与backed处理。

NSMutableAttributedString *atr = [NSMutableAttributedString yy_attachmentStringWithEmojiImage:emoticon fontSize:fontSize];
NSAttributedString *checkText = [[NSAttributedString alloc] initWithString:@"查看图片"
                                                                attributes:@{
                                                     NSFontAttributeName: _normalFont,
                                        NSForegroundColorAttributeName  :_atTextColor }];
[atr appendAttributedString:checkText];
                    
YYTextBinding *binding = [YYTextBinding bindingWithDeleteConfirm:YES];
[atr yy_setTextBinding:binding range:NSMakeRange(0, atr.length)];
[atr yy_setTextBackedString:[YYTextBackedString stringWithString:subStr] range:NSMakeRange(0, atr.length)];
[text replaceCharactersInRange:oneRange withAttributedString:atr];

这里还有一步,和之前只加图片不同,当协议方法调用并替换后,再次调用协议方法会发现传入的text变成了\U0000fffc查看图片 并非是赋值的YYTextBackedString,而在控制器打印textView.text没问题,所以这里会造成“查看图片”这四个字失去了设置的颜色,而被设置上了普通文字的颜色。
不过解决起来很简单,像匹配@标记一样增加一条正则:

    _regexImageCheck = regexp("\U0000fffc查看图片", 0);

然后再次匹配重设颜色即可。这里会有一个小bug,YYText会把图片统一处理成\U0000fffc字符所以任意图片后的“查看图片”四字都会被重设高亮,目前还没有更好的方案,未来再做优化。

本文章的Demo工程

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 203,362评论 5 477
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 85,330评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 150,247评论 0 337
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,560评论 1 273
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,580评论 5 365
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,569评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,929评论 3 395
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,587评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,840评论 1 297
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,596评论 2 321
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,678评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,366评论 4 318
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,945评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,929评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,165评论 1 259
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 43,271评论 2 349
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,403评论 2 342

推荐阅读更多精彩内容

  • 发现 关注 消息 iOS 第三方库、插件、知名博客总结 作者大灰狼的小绵羊哥哥关注 2017.06.26 09:4...
    肇东周阅读 12,016评论 4 62
  • 标题写得这么夸张,甚至是撕心裂肺,因为我想表达一个观点:phonics是辅助阅读的科学方法论,是为孩子自主阅读服务...
    兔思思阅读 391评论 0 0
  • 女儿问,妈妈最喜欢什么,我毫不犹豫地回答:“喜欢睡觉。”小东西也毫不犹豫地回答:“那我就是‘睡觉’。”
    童心不改阅读 123评论 0 1