110 lines
2.9 KiB
Go
110 lines
2.9 KiB
Go
/*
|
|
* Amsterdam Web Communities System
|
|
* Copyright (c) 2025 Erbosoft Metaverse Design Solutions, All Rights Reserved
|
|
*
|
|
* This Source Code Form is subject to the terms of the Mozilla Public
|
|
* License, v. 2.0. If a copy of the MPL was not distributed with this
|
|
* file, You can obtain one at https://mozilla.org/MPL/2.0/.
|
|
*/
|
|
|
|
// Package ui holds the support for the Amsterdam user interface, wrapping Echo and Jet templates.
|
|
package ui
|
|
|
|
import (
|
|
"embed"
|
|
"fmt"
|
|
|
|
"gopkg.in/yaml.v3"
|
|
)
|
|
|
|
// DialogItem holds the dialog item definition.
|
|
type DialogItem struct {
|
|
Type string `yaml:"type"`
|
|
Name string `yaml:"name"`
|
|
Caption string `yaml:"caption,omitempty"`
|
|
Subcaption string `yaml:"subcaption,omitempty"`
|
|
Required bool `yaml:"required,omitempty"`
|
|
Size int `yaml:"size,omitempty"`
|
|
MaxLength int `yaml:"maxlength,omitempty"`
|
|
Value string `yaml:"value,omitempty"`
|
|
Param string `yaml:"param,omitempty"`
|
|
}
|
|
|
|
// Dialog holds the dialog definition.
|
|
type Dialog struct {
|
|
Name string `yaml:"name"`
|
|
FormName string `yaml:"formName"`
|
|
MenuSelector string `yaml:"menuSelector,omitempty"`
|
|
Title string `yaml:"title"`
|
|
Action string `yaml:"action"`
|
|
Instructions string `yaml:"instructions,omitempty"`
|
|
Fields []DialogItem `yaml:"fields"`
|
|
}
|
|
|
|
//go:embed dialogs/*
|
|
var dialogs embed.FS
|
|
|
|
/* AmLoadDialog loads a dialog definition.
|
|
* Parameters:
|
|
* name - The name of the dialog to load
|
|
*/
|
|
func AmLoadDialog(name string) (*Dialog, error) {
|
|
b, err := dialogs.ReadFile(fmt.Sprintf("dialogs/%s.yaml", name))
|
|
if err == nil {
|
|
var d Dialog
|
|
err = yaml.Unmarshal(b, &d)
|
|
if err == nil {
|
|
// "nil-patch" certain fields
|
|
if d.MenuSelector == "" {
|
|
d.MenuSelector = "nochange"
|
|
}
|
|
for _, fld := range d.Fields {
|
|
if fld.Type == "button" && fld.Param == "" {
|
|
fld.Param = "blue"
|
|
}
|
|
if fld.Type == "date" && fld.Param == "" {
|
|
fld.Param = "year:-100"
|
|
}
|
|
}
|
|
return &d, nil
|
|
}
|
|
}
|
|
return nil, err
|
|
}
|
|
|
|
/* Field returns a pointer to a dialog's field, given its name.
|
|
* Parameters:
|
|
* name - The name of the field to find.
|
|
* Returns:
|
|
* Pointer to the field, or nil.
|
|
*/
|
|
func (d *Dialog) Field(name string) *DialogItem {
|
|
for i := 0; i < len(d.Fields); i++ {
|
|
if d.Fields[i].Name == name {
|
|
return &(d.Fields[i])
|
|
}
|
|
}
|
|
return nil
|
|
}
|
|
|
|
/* Render sets up the rendering parameters to send this dialog to the output.
|
|
* Parameters:
|
|
* ctxt - The AmContext for this request.
|
|
* Returns:
|
|
* Command string dictating what to be rendered.
|
|
* Data as a parameter for the command string.
|
|
* Standard Go error status.
|
|
*/
|
|
func (d *Dialog) Render(ctxt AmContext) (string, any, error) {
|
|
required := false
|
|
for _, fld := range d.Fields {
|
|
if fld.Required {
|
|
required = true
|
|
break
|
|
}
|
|
}
|
|
ctxt.VarMap().Set("amsterdam_required", required)
|
|
ctxt.VarMap().Set("amsterdam_dialog", d)
|
|
return "framed_template", "dialog.jet", nil
|
|
}
|