03 · MVU 与消息

四个角色

角色	签名（示意）	职责
Model	任意 struct	业务状态
Msg	封闭类型集	发生了什么
Update	func(*M, Msg) Cmd[Msg]	改 Model，可选副作用
View	func(*Context, M, Send[Msg]) Widget	只读渲染

推荐：封闭消息集

type Msg interface{ msg() }

type NameChanged struct{ Name string }
type Submitted struct{}

func (NameChanged) msg() {}
func (Submitted) msg() {}

func Update(m *Model, msg Msg) ui.Cmd[Msg] {
    switch msg := msg.(type) {
    case NameChanged:
        m.Name = msg.Name
    case Submitted:
        // ...
    }
    return nil
}

优点：

• switch 穷尽、可重构
• 子模块消息可嵌套（见下文）

View 规则

func View(ctx *ui.Context, m Model, send ui.Send[Msg]) ui.Widget {
    // ✓ 读 m
    // ✓ 回调里 send(...)
    // ✗ m.Count++ 或 *m = ...
    // ✗ 在 View 里 go 启动改状态的 goroutine
    return ui.Text(m.Name)
}

回调里只表达意图：

ui.Button("save", ui.Text("保存")).OnClick(func() {
    send(Submitted{})
})

单窗口：ui.Run(Program)

ui.Run(ui.NewProgram(Model{}, Update, View),
    ui.Title("App"),
    ui.Size(800, 600),
)

NewProgram 适合固定初始 Model。Update 始终返回 Cmd；没有副作用时返回 nil。

完整 Program

ui.Run(ui.Program[Model, Msg]{
    Init: func() (Model, ui.Cmd[Msg]) {
        return Model{}, loadInitial()
    },
    Update: func(m *Model, msg Msg) ui.Cmd[Msg] {
        // 先改完 Model，再返回 Cmd
        return nil
    },
    Subscriptions: func(m Model) []ui.Subscription[Msg] {
        return nil
    },
    View: View,
    // 可选：把窗口尺寸/焦点映射成消息
    // WindowStateMessage: func(ui.WindowState) Msg { ... },
},
    ui.Title("App"),
    ui.Size(800, 600),
)

字段	说明
Init	每窗口实例一次；可带初始 Cmd
Update	改 Model 后返回 Cmd
Subscriptions	按当前 Model 声明订阅集合
View	渲染
WindowStateMessage	原生窗口状态 → Msg

异步细节见 08-命令与订阅。

嵌套模块

子包可有自己的 Model / Msg / Update / View，父级包装消息：

type CounterMsg struct{ Value counter.Msg }

func Update(model *Model, msg Msg) ui.Cmd[Msg] {
    switch msg := msg.(type) {
    case CounterMsg:
        cmd := counter.Update(&model.Counter, msg.Value)
        return ui.MapCmd(cmd, func(child counter.Msg) Msg {
            return CounterMsg{Value: child}
        })
    }
    return nil
}

View 侧把子 send 映射上去：

ui.Key("counter", counter.View(model.Counter, func(msg counter.Msg) {
    send(CounterMsg{Value: msg})
}))

完整示例：examples/modules。

Action 与 Cmd

类型	用途
Cmd	MVU 异步副作用（网络、IO、延时）
Action	菜单项、工具栏、快捷键配方（NewAction、ActionMenuItem…）

不要混名：Command 旧说法已拆成 Cmd 与 Action。

常见选项

ui.Run(ui.NewProgram(Model{}, Update, View),
    ui.Title("标题"),
    ui.Size(960, 640),
    ui.MinSize(400, 300),
    ui.CustomizeTheme(func(t *ui.Theme) {
        // 改主题
    }),
    ui.Locale(ui.LanguageChinese),
    ui.OnError(func(err error) {
        // 记录 EffectError / RuntimePanicError 等
        log.Println(err)
    }),
)

下一步

• 04-布局
• 08-命令与订阅