Flet V3 开发指南
本技能旨在强制执行 Flet 0.80+ 版本的最新 API 规范，确保 UI 代码的高性能与稳定性。
核心原则 (Modern Flet)
- •架构先行: 必须严格遵循
ft.Tabs控制器架构，嵌套使用ft.TabBar和ft.TabBarView。 - •文档驱动: 开发前必须查阅
references/component_specs.md获取组件参数，或通过references/verified_api.md访问官方文档。 - •安全更新: 任何
.update()必须包裹在try-except中，防止组件未挂载时的RuntimeError。 - •大写规范: 常量必须大写（如
ft.Alignment.CENTER,ft.Colors.BLUE,ft.MainAxisAlignment.SPACE_BETWEEN）。
常用适配速查
| 需求 | 正确做法 |
|---|---|
| Tab 标签 | 必须使用 label="名称"，严禁使用 text。 |
| Tabs 切换 | on_change 事件必须绑定在 ft.Tabs 顶层。 |
| 开启对话框 | 使用 page.show_dialog(control)。 |
| 关闭对话框 | 使用 page.pop_dialog()。 |
| 两端对齐 | 使用 ft.MainAxisAlignment.SPACE_BETWEEN。 |
| 文本边距 | ft.Container(content=ft.Text(...), padding=10) |
| 手势坐标 | dx = getattr(e, 'delta_x', getattr(e, 'dx', 0)) |
参考文档体系
- •官方文档索引 (verified_api.md): 包含官方文档全量分类链接。
- •核心组件详表 (component_specs.md): 存储经核实的常用组件参数详情。
- •API 破坏性更新对照: 记录历史变更。