QMUITableViewCell

@interface QMUITableViewCell : UITableViewCell

@property(nonatomic, assign, readonly) UITableViewCellStyle style;

/**
 *  调整 imageView 的位置偏移，常用于调整 imageView 和 textLabel 之间的间距，默认为 UIEdgeInsetsZero。
 *  @warning 目前只对 UITableViewCellStyleDefault 和 UITableViewCellStyleSubtitle 类型的 cell 开放
 */
@property(nonatomic, assign) UIEdgeInsets imageEdgeInsets;

/**
 *  调整 textLabel 的位置偏移，默认为 UIEdgeInsetsZero。
 *  @warning 目前只对 UITableViewCellStyleDefault 和 UITableViewCellStyleSubtitle 类型的 cell 开放
 */
@property(nonatomic, assign) UIEdgeInsets textLabelEdgeInsets;

/// 调整 detailTextLabel 的位置偏移，默认为 UIEdgeInsetsZero。
@property(nonatomic, assign) UIEdgeInsets detailTextLabelEdgeInsets;

/**
 调整右边 accessoryView 的布局偏移，默认为 UIEdgeInsetsZero。
 @warning 对系统原生的 view 不生效（例如向右箭头、“i”详情按钮等），如果通过配置表设置了 TableViewCellDisclosureIndicatorImage，由于该配置本质上是使用了自定义的 accessoryView 来实现，所以这个属性对其生效。
 */
@property(nonatomic, assign) UIEdgeInsets accessoryEdgeInsets;

/**
 调整右边 accessoryView 的点击响应区域，可用负值扩大点击范围，默认为(-12, -12, -12, -12)。
 @warning 对系统原生的 view 不生效（例如向右箭头、“i”详情按钮等），如果通过配置表设置了 TableViewCellDetailButtonImage，由于该配置本质上是使用了自定义的 accessoryView 来实现，所以这个属性对其生效。
 */
@property(nonatomic, assign) UIEdgeInsets accessoryHitTestEdgeInsets;

/// 设置当前 cell 是否可用，setter 方法里面会修改当前的 subviews 样式，以展示出禁用的样式，具体样式请查看源码。
@property(nonatomic, assign, getter = isEnabled) BOOL enabled;

/// 保存对 tableView 的弱引用，在布局时可能会使用到 tableView 的一些属性例如 separatorColor 等
@property(nonatomic, weak, nullable) UITableView *parentTableView;

/**
 *  cell 处于 section 中的位置，要求：
 *  1. cell 使用 initForTableViewXxx 方法初始化，或者初始化完后为 parentTableView 属性赋值。
 *  2. 在 cellForRow 里调用 [cell updateCellAppearanceWithIndexPath:] 方法。
 *  3. 之后即可通过 cellPosition 获取到正确的位置。
 */
@property(nonatomic, assign, readonly) QMUITableViewCellPosition cellPosition;

/**
 *  首选初始化方法
 *
 *  @param tableView       cell所在的tableView
 *  @param style           tableView的style
 *  @param reuseIdentifier tableView的reuseIdentifier
 *
 *  @return 一个QMUITableViewCell实例
 */
- (nullable instancetype)initForTableView:(nullable UITableView *)tableView withStyle:(UITableViewCellStyle)style reuseIdentifier:(NSString *)reuseIdentifier;

/// 同上
- (nullable instancetype)initForTableView:(nullable UITableView *)tableView withReuseIdentifier:(NSString *)reuseIdentifier;

@end

Undocumented

  • Undocumented

    Declaration

    Objective-C

    @property(nonatomic, assign, readonly) UITableViewCellStyle style

    Swift

    var style: UITableViewCell.CellStyle { get }

  • 调整 imageView 的位置偏移，常用于调整 imageView 和 textLabel 之间的间距，默认为 UIEdgeInsetsZero。

    Warning

    目前只对 UITableViewCellStyleDefault 和 UITableViewCellStyleSubtitle 类型的 cell 开放

    Declaration

    Objective-C

    @property (nonatomic) UIEdgeInsets imageEdgeInsets;

    Swift

    var imageEdgeInsets: UIEdgeInsets { get set }

  • 调整 textLabel 的位置偏移，默认为 UIEdgeInsetsZero。

    Warning

    目前只对 UITableViewCellStyleDefault 和 UITableViewCellStyleSubtitle 类型的 cell 开放

    Declaration

    Objective-C

    @property (nonatomic) UIEdgeInsets textLabelEdgeInsets;

    Swift

    var textLabelEdgeInsets: UIEdgeInsets { get set }

  • 调整 detailTextLabel 的位置偏移，默认为 UIEdgeInsetsZero。

    Declaration

    Objective-C

    @property (nonatomic) UIEdgeInsets detailTextLabelEdgeInsets;

    Swift

    var detailTextLabelEdgeInsets: UIEdgeInsets { get set }

  • 调整右边 accessoryView 的布局偏移，默认为 UIEdgeInsetsZero。

    Warning

    对系统原生的 view 不生效（例如向右箭头、“i”详情按钮等），如果通过配置表设置了 TableViewCellDisclosureIndicatorImage，由于该配置本质上是使用了自定义的 accessoryView 来实现，所以这个属性对其生效。

    Declaration

    Objective-C

    @property (nonatomic) UIEdgeInsets accessoryEdgeInsets;

    Swift

    var accessoryEdgeInsets: UIEdgeInsets { get set }

  • 调整右边 accessoryView 的点击响应区域，可用负值扩大点击范围，默认为(-12, -12, -12, -12)。

    Warning

    对系统原生的 view 不生效（例如向右箭头、“i”详情按钮等），如果通过配置表设置了 TableViewCellDetailButtonImage，由于该配置本质上是使用了自定义的 accessoryView 来实现，所以这个属性对其生效。

    Declaration

    Objective-C

    @property (nonatomic) UIEdgeInsets accessoryHitTestEdgeInsets;

    Swift

    var accessoryHitTestEdgeInsets: UIEdgeInsets { get set }

  • 设置当前 cell 是否可用，setter 方法里面会修改当前的 subviews 样式，以展示出禁用的样式，具体样式请查看源码。

    Declaration

    Objective-C

    @property (nonatomic, getter=isEnabled) BOOL enabled;

    Swift

    var isEnabled: Bool { get set }

  • 保存对 tableView 的弱引用，在布局时可能会使用到 tableView 的一些属性例如 separatorColor 等

    Declaration

    Objective-C

    @property (nonatomic, weak, nullable) UITableView *parentTableView;

    Swift

    weak var parentTableView: UITableView? { get set }

  • cell 处于 section 中的位置，要求：

    1. cell 使用 initForTableViewXxx 方法初始化，或者初始化完后为 parentTableView 属性赋值。
    2. 在 cellForRow 里调用 [cell updateCellAppearanceWithIndexPath:] 方法。
    3. 之后即可通过 cellPosition 获取到正确的位置。

    Declaration

    Objective-C

    @property (nonatomic, readonly) int cellPosition;

    Swift

    var cellPosition: UITableView.ScrollPosition { get }

  • 首选初始化方法

    Declaration

    Objective-C

    - (nullable instancetype)initForTableView:(nullable UITableView *)tableView
                                withStyle:(UITableViewCellStyle)style
                          reuseIdentifier:(nonnull NSString *)reuseIdentifier;

    Swift

    init?(for tableView: UITableView?, with style: UITableViewCell.CellStyle, reuseIdentifier: String)

    Parameters

    tableView

    cell所在的tableView
    style

    tableView的style
    reuseIdentifier

    tableView的reuseIdentifier

    Return Value

    一个QMUITableViewCell实例

  • 同上

    Declaration

    Objective-C

    - (nullable instancetype)initForTableView:(nullable UITableView *)tableView
                      withReuseIdentifier:(nonnull NSString *)reuseIdentifier;

    Swift

    init?(for tableView: UITableView?, withReuseIdentifier reuseIdentifier: String)

QMUISubclassingHooks

  • 初始化时调用的方法，会在两个 NS_DESIGNATED_INITIALIZER 方法中被调用，所以子类如果需要同时支持两个 NS_DESIGNATED_INITIALIZER 方法，则建议把初始化时要做的事情放到这个方法里。否则仅需重写要支持的那个 NS_DESIGNATED_INITIALIZER 方法即可。

    Declaration

    Objective-C

    - (void)didInitializeWithStyle:(UITableViewCellStyle)style;

    Swift

    func didInitialize(with style: UITableViewCell.CellStyle)

  • 用于继承的接口，设置一些cell相关的UI，需要自 cellForRowAtIndexPath 里面调用。默认实现是设置当前cell在哪个position。

    Declaration

    Objective-C

    - (void)updateCellAppearanceWithIndexPath:(nullable NSIndexPath *)indexPath;

    Swift

    func updateAppearance(with indexPath: IndexPath?)