Many years ago I built and demoed a prototype of a simple web ui with a slider, and as you moved it left and right, it started up or shutdown some number of virtual machines. The webui was standalone code, but the rough idea of having events from a high-level overview flow into mgmt, was what I wanted to test out. At this stage, I didn't even have the language built yet. This prototype helped convince me of the way a web ui would fit into everything. Years later, I build an autogrouping prototype which looks quite similar to what we have today. I recently picked it back up to polish it a bit more. It's certainly not perfect, and might even be buggy, but it's useful enough that it's worth sharing. If I had more cycles, I'd probably consider removing the "store" mode, and replace it with the normal "value" system, but we would need the resource "mutate" API if we wanted this. This would allow us to directly change the "value" field, without triggering a graph swap, which would be a lot less clunky than the "store" situation. Of course I'd love to see a GTK version of this concept, but I figured it would be more practical to have a web ui over HTTP. One notable missing feature, is that if the "web ui" changes (rather than just a value changing) we need to offer to the user to reload it. It currently doesn't get an event for that, and so don't confuse your users. We also need to be better at validating "untrusted" input here. There's also no major reason to use the "gin" framework, we should probably redo this with the standard library alone, but it was easier for me to push out something quick this way. We can optimize that later. Lastly, this is all quite ugly since I'm not a very good web dev, so if you want to make this polished, please do! The wasm code is also quite terrible due to limitations in the compiler, and maybe one day when that works better and doesn't constantly deadlock, we can improve it.
83 lines
3.1 KiB
Go
83 lines
3.1 KiB
Go
// Mgmt
|
|
// Copyright (C) James Shubin and the project contributors
|
|
// Written by James Shubin <james@shubin.ca> and the project contributors
|
|
//
|
|
// This program is free software: you can redistribute it and/or modify
|
|
// it under the terms of the GNU General Public License as published by
|
|
// the Free Software Foundation, either version 3 of the License, or
|
|
// (at your option) any later version.
|
|
//
|
|
// This program is distributed in the hope that it will be useful,
|
|
// but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
// GNU General Public License for more details.
|
|
//
|
|
// You should have received a copy of the GNU General Public License
|
|
// along with this program. If not, see <https://www.gnu.org/licenses/>.
|
|
//
|
|
// Additional permission under GNU GPL version 3 section 7
|
|
//
|
|
// If you modify this program, or any covered work, by linking or combining it
|
|
// with embedded mcl code and modules (and that the embedded mcl code and
|
|
// modules which link with this program, contain a copy of their source code in
|
|
// the authoritative form) containing parts covered by the terms of any other
|
|
// license, the licensors of this program grant you additional permission to
|
|
// convey the resulting work. Furthermore, the licensors of this program grant
|
|
// the original author, James Shubin, additional permission to update this
|
|
// additional permission if he deems it necessary to achieve the goals of this
|
|
// additional permission.
|
|
|
|
// Package common contains some code that is shared between the wasm and the
|
|
// http:ui packages.
|
|
package common
|
|
|
|
const (
|
|
// HTTPUIInputType represents the field in the "Type" map that specifies
|
|
// which input type we're using.
|
|
HTTPUIInputType = "type"
|
|
|
|
// HTTPUIInputTypeText is the representation of the html "text" type.
|
|
HTTPUIInputTypeText = "text"
|
|
|
|
// HTTPUIInputTypeRange is the representation of the html "range" type.
|
|
HTTPUIInputTypeRange = "range"
|
|
|
|
// HTTPUIInputTypeRangeMin is the html input "range" min field.
|
|
HTTPUIInputTypeRangeMin = "min"
|
|
|
|
// HTTPUIInputTypeRangeMax is the html input "range" max field.
|
|
HTTPUIInputTypeRangeMax = "max"
|
|
|
|
// HTTPUIInputTypeRangeStep is the html input "range" step field.
|
|
HTTPUIInputTypeRangeStep = "step"
|
|
)
|
|
|
|
// Form represents the entire form containing all the desired elements.
|
|
type Form struct {
|
|
// Elements is a list of form elements in this form.
|
|
// TODO: Maybe this should be an interface?
|
|
Elements []*FormElement `json:"elements"`
|
|
}
|
|
|
|
// FormElement represents each form element.
|
|
type FormElement struct {
|
|
// Kind is the kind of form element that this is.
|
|
Kind string `json:"kind"`
|
|
|
|
// ID is the unique public id for this form element.
|
|
ID string `json:"id"`
|
|
|
|
// Type is a map that you can use to build the input field in the ui.
|
|
Type map[string]string `json:"type"`
|
|
|
|
// Sort is a string that you can use to determine the global sorted
|
|
// display order of all the elements in a ui.
|
|
Sort string `json:"sort"`
|
|
}
|
|
|
|
// FormElementGeneric is a value store.
|
|
type FormElementGeneric struct {
|
|
// Value holds the string value we're interested in.
|
|
Value string `json:"value"`
|
|
}
|