WPAttributedMarkup：为你的iOS应用赋予样式化的文本魅力

1、项目介绍

WPAttributedMarkup 是一个轻量级的工具类库，专门为iOS开发者提供便利，使他们能够轻松地从带有标记标签的文本创建富文本（NSAttributedString）。这个实用的类别将类似HTML的文本结构转化为具有自定义样式的本地化字符串，为你的App界面带来更加丰富和动态的视觉效果。

2、项目技术分析

WPAttributedMarkup 通过扩展 NSMutableString 和 NSString 类别实现其功能。其中，NSMutableString+TagReplace 负责去除文本中的标签，并记录下标签的位置，而 NSString+WPAttributedMarkup 提供了一个公共方法 - (NSAttributedString *)attributedStringWithStyleBook:(NSDictionary *)styleBook; 用于解析这些标签并应用对应的样式。

这个过程支持以下几种类型的数据作为样式：

• UIColor：设置文本颜色。
• UIFont：设定字体。
• NSDictionary：添加自定义的属性键值对，如下划线、删除线等。
• NSArray：可合并多个样式应用到同一段文本。
• NSString：引用已有的样式。
• UIImage：在文本中插入图片。

3、项目及技术应用场景

• 用户指南：创建带有链接或操作提示的交互式帮助文本，比如"点击这里查看详细信息"。
• 通知消息：显示带有多样式的消息，如加粗重要部分或用不同颜色区分状态。
• 评论展示：显示带有表情、链接甚至图片的用户评论。
• 个性化设置：允许用户自定义文本样式，比如字体大小、颜色等。

4、项目特点

• 高效：相比于使用NSAttributedString的默认HTML转换方法，本库的处理速度更快，且同步执行，避免了滚动时的卡顿问题。
• 灵活：自定义标签，可以根据需求创建不同的样式，不局限于HTML标准标签。
• 易用：简单的API接口，只需一行代码即可完成富文本的构建。
• 扩展性：提供了WPHighlightLabel等额外组件，可以方便地添加触控事件，实现文本的交互功能。

示例

下面是一个简单的例子，展示了如何使用WPAttributedMarkup创建带有多种样式的文本：

let styleBook = [
    "body": UIFont(name: "HelveticaNeue", size: 18.0)!,
    "bold": UIFont(name: "HelveticaNeue-Bold", size: 18.0)!,
    "red": UIColor.red,
    "help": WPAttributedStyleAction(styledActionWithAction: {
        print("Help action")
    }),
    "settings": WPAttributedStyleAction(styledActionWithAction: {
        print("Settings action")
    }),
    "link": UIColor.orange
]

let attributedText = "Tap <help>here</help> to show help or <settings>here</settings> to show settings".attributedString(withStyleBook: styleBook)

在这段代码中，我们定义了一组样式，包括基本字体、加粗、红色和两个触发动作的标签。当用户点击"here"时，相应的行动会被执行。

总的来说，WPAttributedMarkup 是一个强大且易于使用的工具，能让你的iOS应用的文本呈现出更丰富的表现力。如果你正寻找一种快速、灵活的方式来展示和操作富文本，那么这个项目绝对值得尝试。