目录
- UITableViewCell
- 初始化
-
重用Cell
- reuseIdentifier
- prepareForReuse
- 预定义内容
-
固有视图
- contentView
- backgroundView
- 附属视图
- accessoryType
- accessoryView
- 选择和高亮
- selecte
- selectionStyle
- highlighted
- 编辑
- editing
- editingStyle
- showingConfirmation
- showsReorderControl
- 状态切换
- TransitionToState:
- 内容缩进
- indentation
- separatorInset
UITableViewCell
包含属性和方法用于设置和管理Cell的内容和背景(包括文本、图片、和自定义视图)、管理Cell选择和高亮状态、辅助视图、以及编辑内容。
在创建Cell时，您可以自己定制它们或使用几个预定义样式之一。
使用预定义的样式：
单元格提供标签和图像子视图，它们的位置和样式是固定的。初始化它使用initWithStyle:reuseIdentifier:方法或配置在Xcode中细胞与风格。要设置单元格的文本和图像，请使用textLabel、detailTextLabel和imageView属性。定制自己的Cell：
可以向单元格的contentView属性添加子视图。在添加子视图时，您负责定位这些视图并自己设置它们的内容。
对Cell内容进行配置推荐在tableView:willDisplayCell:forRowAtIndexPath:中进行。
初始化
使用样式和重用标识符初始化
- (instancetype)initWithStyle:(UITableViewCellStyle)style
reuseIdentifier:(NSString *)reuseIdentifier;
重用Cell
-
reuseIdentifier
重用标识符
@property(nonatomic, readonly, copy) NSString *reuseIdentifier;
一旦创建了Cell则不可更改
-
- prepareForReuse
即将被重用时将被调用
- (void)prepareForReuse;
一旦Cell即将被dequeueReusableCellWithIdentifier:返回时将被调用。
apple推荐我们在此处进行一些与内容无关的复位操作、比如alpha、编辑和选择状态。
而内容的清空与覆盖则交给tableView:cellForRowAtIndexPath以提升性能。
预定义内容
所有cell都可以使用的三个基本组件
@property (nonatomic, readonly, strong, nullable) UIImageView *imageView NS_AVAILABLE_IOS(3_0); // 图片
@property (nonatomic, readonly, strong, nullable) UILabel *textLabel NS_AVAILABLE_IOS(3_0); // 内容
@property (nonatomic, readonly, strong, nullable) UILabel *detailTextLabel NS_AVAILABLE_IOS(3_0);//标题
需要注意的是、这三个属性默认都是nil。并且只有在被使用时才创建该控件并添加在contentView。(这个特性和UIButton一样、能提升很多性能、在我们自己设计控件时很值得借鉴)
固有视图
-
contentView
内容视图
@property(nonatomic, readonly, strong) UIView *contentView;
自定义控件必须要添加在contentView上：
- 触发高度的自适应。
- 编辑tableView时内容的偏移效果
-
backgroundView
背景视图
@property(nonatomic, strong) UIView *backgroundView;//默认时
@property(nonatomic, strong) UIView *selectedBackgroundView;//单选时
@property(nonatomic, strong) UIView *multipleSelectionBackgroundView;//多选时
该视图处于contentView下方
附属视图
附属视图位于cell右侧
你可以参阅《iOS文档补完计划--UITableViewDataSource&&UITableViewDelegate》中关于扩展按钮的解释
-
accessoryType
默认状态的附属视图类型
@property(nonatomic) UITableViewCellAccessoryType accessoryType;
默认是UITableViewCellAccessoryNone
-
accessoryView
默认状态的附属视图
@property(nonatomic, strong) UIView *accessoryView;
如果该值不为nil、将会忽略accessoryType属性的设置。
选择和高亮
-
selecte
选择状态
@property(nonatomic, getter=isSelected) BOOL selected;
- (void)setSelected:(BOOL)selected
animated:(BOOL)animated;
这个值与你是否显示的展示选择状态(selectionStyle)无关。
可以影响标签、图像和背景的外观。
-
selectionStyle
选择状态的样式
@property(nonatomic) UITableViewCellSelectionStyle selectionStyle;
默认UITableViewCellSelectionStyleBlue、通过设置为UITableViewCellSelectionStyleNone可以关闭选择效果。
-
highlighted
高亮状态
@property(nonatomic, getter=isHighlighted) BOOL highlighted;
- (void)setHighlighted:(BOOL)highlighted
animated:(BOOL)animated;
要使高亮显示正常工作，您必须使用textLabel和detailTextLabel属性获取单元格的标签，并设置每个标签的highlightedTextColor属性;对于图像，使用imageView属性获取单元格的图像，并设置UIImageView对象的highlightedImage属性。
编辑
-
editing
编辑状态
@property(nonatomic, getter=isEditing) BOOL editing;
- (void)setEditing:(BOOL)editing
animated:(BOOL)animated;
-
editingStyle
编辑状态样式
@property(nonatomic, readonly) UITableViewCellEditingStyle editingStyle;
默认值UITableViewCellEditingStyleNone(不可编辑)
在tableView:editingStyleForRowAtIndexPath:返回特定的值
-
showingConfirmation
当前是否正在显示删除按钮
@property(nonatomic, readonly) BOOL showingDeleteConfirmation;
-
showsReorderControl
设置是否显示cell自带的自动排序控件
@property(nonatomic) BOOL showsReorderControl;
状态切换
-
TransitionToState:
单元格状态之间转换之前被调用(例如从正常状态(默认状态)到编辑模式)
- (void)willTransitionToState:(UITableViewCellStateMask)state;
- (void)didTransitionToState:(UITableViewCellStateMask)state
自定义单元格可以设置和定位新状态下出现的任何新视图。然后，cell接收到layoutSubviews消息(UIView)，在该消息中，它可以将这些新视图放置在新状态的最终位置。当重写此方法时，子类必须始终调用super。
内容缩进
-
indentation
内容缩进等级和缩进宽度
@property(nonatomic) NSInteger indentationLevel;//内容缩进等级 。默认0
@property(nonatomic) CGFloat indentationWidth;//内容缩进宽度 。默认10
@property(nonatomic) BOOL shouldIndentWhileEditing;//编辑模式下是否缩进
《iOS自定义UITableViewCell不支持缩进的解决》中写道只作用于预定义的cell的textLable
-
separatorInset
内容的内嵌值
@property(nonatomic) UIEdgeInsets separatorInset;
只采用左右、上下的值会被忽略。