如何在KivyMD 2.0.1的MDListItem中设置可点击尾部按钮

一、尾部可点击按钮的正确实现方式 #

1. 使用MDListItemTrailingIcon（图标按钮） #

MDListItemTrailingIcon本身继承自MDIconButton，自带点击交互能力，无需额外嵌套MDButton。直接设置图标和点击事件即可：

MDListItem:
    MDListItemTrailingIcon:
        icon: "trash-can"
        on_release: print("执行删除操作")

之前嵌套MDButton导致无法点击，是因为层级遮挡或事件传递冲突，直接使用MDListItemTrailingIcon即可解决。

2. 使用自定义按钮（非图标类） #

若需要自定义按钮样式，需将容器指定为MDListItem的trailing_widget，而非直接添加到列表项内部。MDListItem的布局分为leading、content、trailing三个固定区域，指定trailing_widget后，组件会自动居右：

MDListItem:
    trailing_widget: custom_trailing_box
    MDBoxLayout:
        id: custom_trailing_box
        size_hint_x: None
        width: dp(60)  # 根据按钮尺寸调整宽度
        MDButton:
            text: "确认"
            on_release: print("按钮被点击")

无需设置pos_hint，因为trailing区域本身就是居右的布局位置。

二、版本选择及2.0.1版本状态 #

• 2.0.1是正式稳定版：KivyMD 2.0.1是官方发布的正式稳定版本，属于MD3风格迭代后的核心版本，后续官方维护和新功能更新都会优先围绕该版本系列。
• 版本选择建议：
  • 若现有项目基于1.20版本开发，且无新版功能需求，可继续使用1.20，其稳定性经过验证，适配成本低。
  • 若需要新版的MD3组件、性能优化或新特性，建议升级到2.0.1。升级时需注意API变化（如MDListItem的结构调整），对照官方文档适配即可。

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