IQKeyboardManager 自定义工具栏完成按钮文本的方法

概述

在使用 IQKeyboardManager 这个流行的 iOS 键盘管理库时，开发者经常需要自定义键盘工具栏上的按钮文本。本文将详细介绍如何在最新版本（7.0.1及以上）中正确设置"完成"按钮的文本。

旧版与新版的区别

在 IQKeyboardManager 7.0.1 版本之前，开发者可以直接通过以下方式设置完成按钮文本：

IQKeyboardManager.shared.toolbarDoneBarButtonItemText = "Готово"

但在 7.0.1 版本中，这个属性已被废弃，取而代之的是更灵活的配置方式。如果开发者仍然尝试使用旧方法，会收到编译错误提示：

'toolbarDoneBarButtonItemText' has been renamed to 'toolbarConfiguration.doneBarButtonConfiguration.title'

新版配置方法

在 IQKeyboardManager 7.0.1 及以上版本中，正确的配置方式如下：

let config = IQBarButtonItemConfiguration(title: "Готово")
IQKeyboardManager.shared.toolbarConfiguration.doneBarButtonConfiguration = config

这种新的配置方式提供了更大的灵活性，允许开发者不仅设置按钮文本，还可以配置其他按钮属性。

深入理解

1. IQBarButtonItemConfiguration：这是一个新的配置类，用于定义工具栏按钮的各种属性，包括但不限于：

   • 标题文本
   • 图片
   • 样式
   • 目标动作等

2. 工具栏配置层级：新版本引入了更清晰的配置层级结构：

   • toolbarConfiguration 管理整个工具栏的配置
   • doneBarButtonConfiguration 专门用于完成按钮的配置

3. 国际化支持：通过这种方式，开发者可以轻松地为不同语言环境设置本地化的完成按钮文本。

最佳实践

1. 建议在应用启动时（如 AppDelegate 中）进行一次性配置
2. 如果需要动态更改文本，确保在主线程执行
3. 考虑为不同的视图控制器设置不同的完成按钮文本

总结

IQKeyboardManager 7.0.1 版本对工具栏按钮的配置方式进行了重构，提供了更灵活、更结构化的 API。开发者应适应新的配置方式，使用 IQBarButtonItemConfiguration 来定制完成按钮的外观和行为。这种改变虽然需要少量代码调整，但为未来的扩展性提供了更好的基础。