MVVM: observables, comandos, binders

go-widgets/mvvm usa solo genéricos, sin reflexión. Su paquete central no importa ningún paquete de widgets, de modo que un mismo view-model controla tanto el toolkit de píxeles como los widgets de terminal.

Un formulario

type FormVM struct {
	Name  *mvvm.Observable[string]
	Names *mvvm.ObservableList[string]
	Save  *mvvm.Command
}

vm := &FormVM{Name: mvvm.NewObservable(""), Names: mvvm.NewObservableList[string]()}
vm.Save = mvvm.NewCommand(
	func() { vm.Names.Append(vm.Name.Get()); vm.Name.Set("") },
	func() bool { return vm.Name.Get() != "" }, // CanExecute
)
mvvm.BindCanExecute(vm.Save, vm.Name) // Save greys out while the name is empty

Enlace

Los binders genéricos llegan a un widget mediante un puntero a su campo de valor y un puntero a su ranura de callback: BindField (bidireccional), OneWay, BindCommand, BindList. Un widget dispara su callback desde su manejador de eventos y deja en silencio una escritura directa del campo, y Observable.Set ignora un valor igual: así, un enlace bidireccional puede hacer eco sin entrar en recursión.

El toolkit está pasando sus widgets a exponer su estado como un observable (Label.Text() devuelve un *mvvm.Observable[string]). Entonces no hay ningún campo que inicializar ni ningún callback que componer, solo dos propiedades que deben coincidir: BindTwoWay(src, dst, invalidate).

Los widgets cuyo callback recibe varios argumentos tienen un pequeño adaptador con nombre en un paquete por backend, los únicos paquetes que importan un backend:

mvvmtk: una llamada por widget

go-widgets/mvvmtk rellena los nombres reales del campo y del callback de cada widget del toolkit, de modo que la vista nunca los nombra:

unbind := mvvmtk.BindText(search, vm.Query, win.Invalidate) // search.Text ⇄ vm.Query
defer unbind()

Cada función devuelve un unbind que desconecta el enlace y restaura el callback que había antes. Un botón enlazado a un comando que no puede ejecutarse no acepta ningún clic, ni Intro ni Espacio, ni el foco del teclado.

Deshacer y rehacer

mvvm/undo es una pila de comandos construida únicamente sobre las primitivas centrales, así que funciona bajo cualquier vista:

s := undo.New() // unlimited, coalescing on; undo.WithLimit(n), undo.WithCoalescing(false)
s.Push(undo.NewCommand("Write hello", do, undoIt))
s.Undo()
s.Redo()

mvvm.BindCommand(s.UndoCommand(), &undoBtn.OnClick, setEnabled)
mvvm.OneWay(s.UndoTextBinding(), &undoBtn.Text, repaint) // "Undo Write hello"

Una serie de pulsaciones de teclas se fusiona en un solo paso, y un push tras un deshacer descarta la cola de rehacer.