MVVM : observables, commandes, binders

go-widgets/mvvm repose uniquement sur les génériques, sans réflexion. Son paquet central n’importe aucun paquet de widgets, si bien qu’un même view-model pilote aussi bien la boîte à outils en pixels que les widgets de terminal.

Un formulaire

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

Liaison

Les binders génériques atteignent un widget par un pointeur vers son champ de valeur et un pointeur vers son emplacement de callback : BindField (bidirectionnel), OneWay, BindCommand, BindList. Un widget déclenche son callback depuis son gestionnaire d’événements et laisse silencieuse une écriture directe dans le champ, et Observable.Set ignore une valeur égale — si bien qu’une liaison bidirectionnelle peut renvoyer l’écho sans récursion.

La boîte à outils fait évoluer ses widgets pour qu’ils exposent leur état sous forme d’un observable (Label.Text() renvoie un *mvvm.Observable[string]). Il n’y a alors plus de champ à initialiser ni de callback à composer, seulement deux propriétés qui doivent s’accorder : BindTwoWay(src, dst, invalidate).

Les widgets dont le callback prend plusieurs arguments reçoivent un petit adaptateur nommé dans un paquet propre à chaque back-end, les seuls paquets qui importent un back-end :

mvvmtk : un appel par widget

go-widgets/mvvmtk renseigne les vrais noms de champ et de callback de chaque widget de la boîte à outils, si bien que la vue ne les nomme jamais :

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

Chaque aide renvoie un unbind qui détache la liaison et restaure le callback qui était là auparavant. Un bouton lié à une commande qui ne peut pas s’exécuter n’accepte ni clic, ni Entrée ou Espace, ni focus clavier.

Annuler et rétablir

mvvm/undo est une pile de commandes construite sur les seules primitives centrales ; elle fonctionne donc sous n’importe quelle vue :

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"

Une suite de frappes se fusionne en une seule étape, et un ajout après une annulation abandonne la suite des actions à rétablir.