如何为tableview中的tableviewcell设置边距及间距,避免contentInset设置后出现横向滚动
UITableView 中 TableViewCell 左右边距的正确实现方法
问题根因排查
使用self.tableView.contentInset = UIEdgeInsets(top: 0, left: 16, bottom: 0, right: 16)实现边距时,会出现仅左侧边距生效、触发tableView横向滚动的异常,核心原因有两点:
- 系统计算Cell宽度时,不会关联contentInset的右偏移值,Cell本身宽度仍等于tableView全宽,右方向的inset只是在滚动区域最右侧叠加了16pt空白,Cell本身没有向内缩进,自然无法看到右侧边距
- 给tableView设置非0的右向contentInset时,系统会自动把contentSize宽度叠加右inset的数值,总宽度超出tableView本身的bounds宽度,直接触发横向滚动
参考效果对照:
- 目标实现效果:

- 当前实际异常效果:

可稳定落地的实现方案
方案1:Cell内部添加内容容器视图(通用推荐方案)
- 在自定义Cell内部新增一个内容容器View,将所有原本直接放在contentView上的UI元素,全部绑定到容器视图上
- 给容器视图添加约束:距离cell的contentView左右边缘各16pt,上下约束保持原有布局不变
这种方案从根源上不会触发横向滚动,左右边距完全可控,能适配屏幕旋转、分屏、tableView动态宽度变化等场景,是绝大多数项目的首选实现方式。
方案2:通过代理方法动态调整Cell Frame
不需要修改Cell内部结构的场景下,可以实现UITableView的willDisplay代理方法,在Cell即将展示时调整frame参数:
func tableView(_ tableView: UITableView, willDisplay cell: UITableViewCell, forRowAt indexPath: IndexPath) { var adjustedFrame = cell.frame adjustedFrame.origin.x = 16 adjustedFrame.size.width = tableView.bounds.width - 32 cell.frame = adjustedFrame }
注意:使用该方案需要额外监听tableView的宽度变化事件,同步重新计算Cell的frame,避免出现边距偏移。
方案3:contentInset 适配 workaround(不推荐长期使用)
如果一定要通过contentInset实现边距,需要补充两个配置抵消横向滚动问题:
- 手动重置tableView的contentSize宽度,抵消系统自动叠加的右inset宽度增量:
self.tableView.contentSize = CGSize( width: self.tableView.bounds.width, height: self.tableView.contentSize.height ) - 关闭横向滚动条显示:
self.tableView.showsHorizontalScrollIndicator = false
这种方式属于临时适配方案,在多场景、动态布局的项目中容易出现不可预期的布局偏移,稳定性远不如前两种方案。
内容的提问来源于stack exchange,提问作者Vandal
相关产品推荐
相关产品推荐

