SZMentions是一个轻量级的iOS提及库。该库旨在帮助在TextView中添加、删除和编辑提及。

如何开始

• 下载SZMentions并尝试iOS示例应用程序。

通讯

• 如果您需要帮助，随时通过@StevenZweier发送推文。
• 如果您发现了一个bug，有功能请求，或有一般性问题，请开启一个问题。
• 如果您想贡献力量，提交一个pull请求。

Podfile

使用CocoaPods将SZMentions集成到您的Xcode项目中，请在其Podfile中指定。

source 'https://github.com/CocoaPods/Specs.git'
platform :ios, '8.0'

pod 'SZMentions'

然后，运行以下命令

$ pod install

要求

用法

以下是对该库中使用对象的快速浏览，但像往常一样，了解SZMentions库当前实现的最佳地方是在示例代码中。

SZMentionsListener

这个类管理提及交互。

设置

使用以下多个初始化器之一设置您的提及监听器。以下参数解释如下

textView : 必须 我们应用提及监听器的文本视图。注意：它的代理 必须 是提及管理器。

mentionsManager : 必须 将处理提及交互的类。

delegate : 可选 如果您希望接收UITextView代理方法，请设置此并将在处理后传递给提及监听器。

defaultTextAttributes : 应用于所有非提及的文本的属性（见：SZAttribute）。

mentionTextAttributes : 设置应用到所有提及文本的属性（参见：SZAttribute）

spaceAfterMention : 可选 是否希望在提及文本末尾添加空格。默认值是 NO

trigger : 用于启动提及的字符串。默认值是 @

cooldownInterval : 可选 在调用 showMentionsList 之间等待的时间。默认值是 0.5

属性

mentions : 只读 当前应用于文本视图的所有提及的数组。

方法

- (void)addMention:(NSObject<SZCreateMentionProtocol> *)mention; : 在添加提及时调用此方法将提及应用到当前文本。

SZCreateMentionProtocol

这些属性是发送到提及监听器的提及所需的

SZMentionsManagerProtocol

用于处理提及交互的要求方法。

- (void)showMentionsListWithString:(NSString *)mentionString; 告诉代理显示提及列表，同时提供当前文本视图中键入的字符串，以便对提及列表进行过滤。

- (void)hideMentionsList; 告诉代理我们不再键入提及。

SZMention

此类通过 mentions 方法返回，它包含提及的 range 以及通过 addMention:(id)mention 方法发送到提及监听器的 object。

SZAttribute

此类用于将属性传递给应用提及文本以及常规文本。

示例

SZAttribute *attribute = [[SZAttribute alloc] initWithAttributeName:NSForegroundColorAttributeName
attributeValue:[UIColor redColor]];

单元测试

SZMentions 包含可以运行在 SZMentions 框架上的单元测试

鸣谢

SZMentions 最初由 Steven Zweier 创建