如何使用UIListContentConfiguration设置自定义XIB单元格的属性？

你遇到的核心问题是：系统默认的UIListContentConfiguration仅对应UITableViewCell内置的默认控件（比如textLabel、imageView），和你通过XIB自定义的label、leftImageView/rightImageView不是同一套控件。直接调用cell.defaultContentConfiguration()并赋值，只会修改系统内置控件，不会影响你自己拖的IBOutlet属性，这就是iOS14+代码无效果的原因。

要让UIListContentConfiguration风格的配置生效，你需要让自定义Cell适配UIContentConfiguration，把配置参数手动映射到你的IBOutlet控件上。以下是具体实现步骤：

1. 创建自定义内容配置类 #

这个类用来封装你需要的所有配置参数（文本、左右头像等），遵循UIContentConfiguration和Hashable协议：

struct MessageContentConfiguration: UIContentConfiguration, Hashable {
    // 定义你需要的配置属性
    var text: String?
    var leftAvatar: UIImage?
    var rightAvatar: UIImage?
    var isOutgoingMessage: Bool = false // 标记是否为自己发送的消息，用于调整气泡样式
    
    // 创建对应的ContentView（这里我们直接在Cell里处理，所以返回空实现即可）
    func makeContentView() -> UIView & UIContentView {
        return UIView()
    }
    
    // 处理状态更新（比如选中、高亮），返回更新后的配置
    func updated(for state: UIConfigurationState) -> MessageContentConfiguration {
        var updatedConfig = self
        // 可选：根据状态调整样式，比如选中时的气泡透明度
        if state.isSelected || state.isHighlighted {
            // 这里可以添加状态相关的配置修改
        }
        return updatedConfig
    }
}

2. 修改自定义Cell，实现配置映射 #

在你的MessageCell里重写updateConfiguration(using:)方法，把自定义配置的参数映射到你的IBOutlet控件上：

class MessageCell: UITableViewCell {

    @IBOutlet weak var rightImageView: UIImageView!
    @IBOutlet weak var leftImageView: UIImageView!
    @IBOutlet weak var label: UILabel!
    @IBOutlet weak var messageBubble: UIView!

    override func awakeFromNib() {
        super.awakeFromNib()
        messageBubble.layer.cornerRadius = messageBubble.frame.height / 5
    }

    override func setSelected(_ selected: Bool, animated: Bool) {
        super.setSelected(selected, animated: animated)
    }
    
    // 核心：根据配置更新控件
    override func updateConfiguration(using state: UIConfigurationState) {
        super.updateConfiguration(using: state)
        
        // 强转成自定义配置
        guard let config = contentConfiguration as? MessageContentConfiguration else { return }
        
        // 映射配置到控件
        label.text = config.text
        leftImageView.image = config.leftAvatar
        rightImageView.image = config.rightAvatar
        
        // 根据消息类型调整控件显示和样式
        leftImageView.isHidden = config.isOutgoingMessage
        rightImageView.isHidden = !config.isOutgoingMessage
        messageBubble.backgroundColor = config.isOutgoingMessage ? .systemBlue : .systemGray5
    }
    
    // 提供自定义配置的默认实现
    override func defaultContentConfiguration() -> UIContentConfiguration {
        return MessageContentConfiguration()
    }
}

3. 在cellForRowAt中使用自定义配置 #

替换原来的代码，创建并赋值自定义配置：

func tableView(_ tableView: UITableView, cellForRowAt indexPath: IndexPath) -> UITableViewCell {
    let cell = tableView.dequeueReusableCell(withIdentifier: K.cellIdentifier, for: indexPath) as! MessageCell
    let message = messages[indexPath.row]
    
    if #available(iOS 14.0, *) {
        var config = MessageContentConfiguration()
        config.text = message.body
        config.isOutgoingMessage = message.sender == currentUserID // 假设你有currentUserID判断发送者
        config.rightAvatar = config.isOutgoingMessage ? UIImage(named: "myAvatar") : nil
        config.leftAvatar = !config.isOutgoingMessage ? UIImage(named: "otherAvatar") : nil
        
        cell.contentConfiguration = config
    } else {
        // iOS14以下的传统实现（保留你原来的逻辑即可）
        cell.label.text = message.body
        let isOutgoing = message.sender == currentUserID
        cell.leftImageView.isHidden = isOutgoing
        cell.rightImageView.isHidden = !isOutgoing
        cell.leftImageView.image = !isOutgoing ? UIImage(named: "otherAvatar") : nil
        cell.rightImageView.image = isOutgoing ? UIImage(named: "myAvatar") : nil
        cell.messageBubble.backgroundColor = isOutgoing ? .systemBlue : .systemGray5
    }
    
    return cell
}

• 自定义配置必须遵循Hashable，这样系统可以缓存配置，提升列表滚动性能。
• updateConfiguration(using:)会在Cell状态变化（选中、高亮、配置更新）时自动调用，所有控件样式调整都可以在这里统一处理，无需分散在setSelected等方法中。
• 如果需要更复杂的样式控制，可以在MessageContentConfiguration中添加更多属性（比如气泡圆角、文本颜色等），统一管理配置逻辑。

内容的提问来源于stack exchange，提问作者batumento