BGTableViewRowActionWithImage 项目教程

BGTableViewRowActionWithImage 项目教程

1、项目介绍

BGTableViewRowActionWithImage 是一个用于 iOS 8-10 的开源项目，旨在为 UITableViewRowAction 添加图标和文本支持。该项目类似于 iOS 9 邮件应用程序和各种第三方应用程序中的功能。然而，需要注意的是，该项目在 iOS 11 及以上版本中不再受支持，因为 Apple 在 iOS 11 中引入了 UIContextualAction，开发者应使用这一新功能。

该项目的主要目的是在 iOS 8-10 中实现类似于 iOS 9 邮件应用程序中的行操作，支持在行操作中显示图标和文本。尽管该项目在 iOS 11 及以上版本中不再受支持，但它仍然可以在这些版本的 iOS 中使用，只是不再维护。

2、项目快速启动

安装

BGTableViewRowActionWithImage 可以通过 CocoaPods 进行安装。在你的 Podfile 中添加以下行：

pod "BGTableViewRowActionWithImage"

然后运行 pod install 命令。

使用

Objective-C

在你的代码中，你可以使用以下构造函数来配置行操作：

// 常规宽度
+ (instancetype)rowActionWithStyle:(UITableViewRowActionStyle)style 
                              title:(NSString *)title 
                    backgroundColor:(UIColor *)backgroundColor 
                              image:(UIImage *)image 
                      forCellHeight:(NSUInteger)cellHeight 
                            handler:(void (^)(UITableViewRowAction *action, NSIndexPath *indexPath))handler;

// 可选的适合宽度（适用于在较小的表格中使用3个或更多单元格时）
+ (instancetype)rowActionWithStyle:(UITableViewRowActionStyle)style 
                              title:(NSString *)title 
                    backgroundColor:(UIColor *)backgroundColor 
                              image:(UIImage *)image 
                      forCellHeight:(NSUInteger)cellHeight 
                    andFittedWidth:(BOOL)isWidthFitted 
                            handler:(void (^)(UITableViewRowAction *action, NSIndexPath *indexPath))handler;

Swift

在 Swift 中，语法略有不同：

// 在你的导入部分：
import BGTableViewRowActionWithImage

// 在你的代码中：
BGTableViewRowActionWithImage.rowActionWithStyle(/* 参见上面的参数 */)

3、应用案例和最佳实践

应用案例

BGTableViewRowActionWithImage 可以用于在 iOS 8-10 的应用程序中实现类似于 iOS 9 邮件应用程序中的行操作。例如，你可以在邮件应用程序中使用此功能来显示删除、标记或移动邮件的图标和文本。

最佳实践

1. 避免手动设置 backgroundColor：手动设置行操作的 backgroundColor 可能会导致意外行为，应避免。
2. 使用 UIContextualAction 替代：在 iOS 11 及以上版本中，应使用 Apple 提供的 UIContextualAction 来实现类似功能。

4、典型生态项目

BGTableViewRowActionWithImage 是一个特定于 iOS 8-10 的项目，因此在 iOS 11 及以上版本中不再推荐使用。对于 iOS 11 及以上版本，开发者应转向使用 Apple 提供的 UIContextualAction。

如果你需要类似的功能，并且你的应用程序支持 iOS 11 及以上版本，建议直接使用 UIContextualAction。对于仍在支持 iOS 8-10 的应用程序，BGTableViewRowActionWithImage 仍然是一个可行的选择。