FluxUI 是一个基于 Gio 的声明式 Go UI 框架。
它不是替代 Gio，而是在 Gio 之上提供更易用的组件化 API、状态管理与动画能力。
- 声明式 UI 结构（函数树）
- 每帧重建 UI（Immediate Mode）
- 统一状态管理与生命周期能力
- 帧驱动动画（不依赖 goroutine）
- 面向工程化的组件与示例体系
- React-style 声明式组件：
RunElement、Element、函数组件、Fragment、Key、Provider - 基础组件：
Text、Button、TextField、Checkbox、Switch、Slider - 布局组件：
Column、Row、Stack、Padding、Container、ScrollView - 导航与弹层：
Router、Tabs、BottomNavigation、Dialog、Toast、Popup - 媒体组件：
Image、Icon、Card - 状态管理：
State[T](ctx)/UseState[T](ctx, initial)（可控状态模式） - Hooks：
UseEffect、UseEffectWithDeps、UseMount、UseLifecycle、UseMemo、UseRef、UseCallback - Context：
Provider、UseContext - 路由 Hooks：
UseParams、UseLocation、UseNavigate - 命令式 Ref：可从外部调用组件方法（如滚动、聚焦、切换、打开/关闭）
- 多窗口能力（桌面端）
- 字体系统：系统字体发现 + 全局/局部字体覆盖
- 帧驱动动画：
Animate+ 缓动函数
依赖方向遵循：
ui -> widget -> (layout/state/anim/event/style) -> internal -> gio
设计约束：
ui是唯一对外入口- 不跨层调用，不破坏模块边界
- 业务逻辑不写在底层渲染层
内部包含 React-style reconciler（元素树 diff + 组件实例管理）、HookStore（组件级 Hook 槽位），以及 Rules of Hooks 校验（防止条件性 hook 调用）。
- Go
1.25+（CI、benchmark 与 release candidate 固定为1.25.12） - 支持 Gio 的桌面运行环境（Windows/macOS/Linux）；X11/Wayland 与 native smoke 边界见
docs/production-governance.md
go mod tidy
go run ./examples/counter最小示例：
package main
import ui "github.com/xiaowumin-mark/FluxUI/ui"
func main() {
_ = ui.Run(func(ctx *ui.Context) ui.Widget {
count := ui.State[int](ctx)
return ui.Center(
ui.Button(
ui.Text("点击 +1"),
ui.OnClick(func(ctx *ui.Context) {
count.Set(count.Value() + 1)
}),
),
)
}, ui.Title("FluxUI Demo"), ui.Size(900, 600))
}React-style 写法：
package main
import ui "github.com/xiaowumin-mark/FluxUI/ui"
func main() {
_ = ui.RunElement(func(ctx *ui.Context) ui.Element {
count := ui.UseState(ctx, 0)
return ui.FromWidget(
ui.Center(
ui.Button(
ui.Text("点击 +1"),
ui.OnClick(func(ctx *ui.Context) {
count.Set(count.Value() + 1)
}),
),
),
)
})
}go run ./examples/counter
go run ./examples/react_workspace
go run ./examples/basic_components
go run ./examples/advanced_components
go run ./examples/layout
go run ./examples/animation_showcase
go run ./examples/state_management
go run ./examples/form_validation
go run ./examples/textfield_demo
go run ./examples/theme_custom
go run ./examples/hooks_lifecycle
go run ./examples/multi_window
go run ./examples/vscode_layout
go run ./examples/icon_fonts
go run ./examples/docs_browser
go run ./examples/network_request
go run ./examples/router
go run ./examples/popup_demo
go run ./examples/team_workspace
go run ./examples/virtual_scroll
go run ./examples/fonts
go run ./examples/horizontal_scroll
go run ./examples/drag_drop_showcaseP7 回归重点入口：
| 入口 | 覆盖 |
|---|---|
go run ./examples/docs_browser |
文档页、搜索、分类 chips、代码块、表格、示例弹窗 |
go run ./examples/component_lab |
样式、hover、cursor、overlay、idle redraw |
go run ./examples/event_system_testbench |
P0-P7 事件、默认行为、诊断和高频输入手工验收 |
go run ./examples/advanced_components |
Select、Dialog、Toast、ListView、ScrollView 综合场景 |
go run ./examples/form_validation |
controlled input、程序化设置、提交验证 |
go run ./examples/horizontal_scroll |
横向滚动和轴向隔离 |
go run ./examples/virtual_scroll |
大列表和大网格虚拟化 |
go run ./examples/drag_drop_showcase |
DragSource、DropTarget、payload 和平台能力探测 |
需要先安装gogio cmd
go install gioui.org/cmd/gogio@latest
gogio -target [platform] -o [output] [package]示例：
gogio -target windows -o example.exe ./examples/counter- 组件文档目录：
docs/widgets - 文档系统说明：
docs/README.md - 示例文档浏览器：
examples/docs_browser - 生产 API、支持矩阵与弃用事实来源：
docs/production-governance.md
fluxui/
├── app/ # 应用与窗口运行时入口
├── ui/ # 对外 API 门面层
├── widget/ # 组件实现
├── layout/ # 布局系统
├── state/ # 状态与生命周期
├── anim/ # 帧驱动动画
├── event/ # 输入事件封装
├── style/ # 样式系统
├── theme/ # 主题与字体
├── internal/ # 内部运行时（不对外暴露）
├── examples/ # 示例应用
└── docs/ # 框架文档
go test ./...P7 相关 smoke 和 benchmark 可单独运行：
go test ./examples/docs_browser ./examples/component_lab
go test ./widget -run '^$' -bench 'Benchmark(WheelScrollViewVertical|HorizontalWheelDelta)' -benchmem
go test ./internal/perf -run '^$' -bench 'Benchmark(LayoutStaticTree|MouseMoveInteractiveTree|ListVirtualized|StaticSurfaceCache)' -benchmem欢迎提交 Issue / PR。
提交前建议：
- 保持模块边界清晰，不跨层依赖
- 为新增能力补充示例与文档
- 运行
go test ./...确保通过