FlowUI 文档¶
FlowUI 是一个基于 Gio 构建的 Go 桌面 UI 框架和组件库。本教程面向应用开发者，从第一个窗口逐步介绍状态管理、布局、样式、组件和桌面应用能力。
阅读路径¶
| 顺序 | 页面 | 内容 |
|---|---|---|
| 1 | 快速开始 | 安装、第一个窗口、运行 |
| 2 | 核心概念 | 三句话、职责边界、术语 |
| 3 | MVU 与消息 | Model / Msg / Update / View、封闭消息集 |
| 4 | 布局 | Box、Row、Column、Scroll、约束 |
| 5 | 样式与主题 | Style、When、Part、Theme、Token |
| 6 | 组件一览 | 控件分类与常用写法 |
| 7 | 表单与受控状态 | Input、Select、Open 契约 |
| 8 | 命令与订阅 | Cmd、Batch、LatestCmd、Subscription |
| 9 | 浮层与弹出 | Modal、Popover、Menu、Toast、Portal |
| 10 | 自定义组件 | 路径 A / B / C |
| 11 | 多窗口 | Application、Open、主题切换 |
| 12 | 动画 | Transition、Tween、Spring、Timeline |
| 13 | 测试 | uitest Harness / AppHarness |
| 14 | 常见问题 | FAQ 与排错 |
| 15 | 甘特图 | 任务排程、依赖、层级与编辑 |
| 16 | 组件截图 | 示例组件的视觉参考 |
| 17 | 节点图 | 节点、端口、连线与受控视口 |
仓库对照¶
| 用途 | 位置 |
|---|---|
| 公开包 | github.com/qianniancn/flowui/ui |
| 可运行示例 | examples/ |
| 架构说明 | FlowUI Architecture |
教程只讲应用如何使用 ui 包；不要求阅读 internal/。
版本说明¶
教程对应仓库当前 API：Go 1.26.2、Gio v0.10.1；单窗口入口为 Run(Program)，
高级生命周期使用 Application。如果本地代码与教程不一致，以 go.mod、
go doc github.com/qianniancn/flowui/ui 和仓库 README 为准。