form

package module
v0.17.1 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Aug 28, 2023 License: Apache-2.0 Imports: 12 Imported by: 11

README

Form 🤔

GoDoc Build Status Codecov Go Report Card Version

JSON to HTML (Forms for Go)

This expandable Go module generates HTML forms using JSON configurations. It is inspired by JSON-Forms but is not compatable with that standard.

DO NOT USE

This project is a work-in-progress, and should NOT be used by ANYONE, for ANY PURPOSE, under ANY CIRCUMSTANCES. It is WILL BE CHANGED UNDERNEATH YOU WITHOUT NOTICE OR HESITATION, and is expressly GUARANTEED to blow up your computer, send your cat into an infinite loop, and combine your hot and cold laundry into a single cycle.

Pull Requests Welcome

This library is a work in progress, and will benefit from your experience reports, use cases, and contributions. If you have an idea for making this library better, send in a pull request. We're all in this together! 🤔

Documentation

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

func Editor added in v0.10.0 

func Editor(schema schema.Schema, element Element, value any, lookupProvider LookupProvider) (string, error)

Viewer creates an in-place form and executes its "Editorr" method

func Register added in v0.9.1 

func Register(name string, widget Widget)

Register adds a new widget into the widget registry.

func SortLookupCodeByGroupThenLabel added in v0.15.0 

func SortLookupCodeByGroupThenLabel(a LookupCode, b LookupCode) bool

SortLookupCodeByGroupThenLabel is a sort function that works with the sort.Slice function.

func SortLookupCodeByLabel added in v0.15.0 

func SortLookupCodeByLabel(a LookupCode, b LookupCode) bool

SortLookupCodeByLabel is a sort function that works with the sort.Slice function.

func Viewer added in v0.10.0 

func Viewer(schema schema.Schema, element Element, value any, lookupProvider LookupProvider) (string, error)

Viewer creates an in-place form and executes its "Viewer" method

Types

type Element added in v0.9.1 

type Element struct {
	Type        string    `json:"type"`                  // The kind of form element
	ID          string    `json:"id"`                    // The ID of the element (needed by some widgets)
	Path        string    `json:"path"`                  // Path to the data value displayed in for this form element
	Label       string    `json:"label,omitempty"`       // Short label to be displayed on the form element
	Description string    `json:"description,omitempty"` // Longer description text to be displayed on the form element
	Options     mapof.Any `json:"options,omitempty"`     // Additional custom properties defined by individual widgets
	Children    []Element `json:"children,omitempty"`    // Array of sub-form elements that may be displayed depending on the kind.
	ReadOnly    bool      `json:"readOnly,omitempty"`    // If true, then this element is read-only
}

Element defines a single form element, or a nested form layout. It can be serialized to and from a database.

func MustParse added in v0.4.0 

func MustParse(data any) Element

MustParse guarantees that a value has been parsed into a Form, or else it panics the application.

func NewElement added in v0.9.1 

func NewElement() Element

func Parse added in v0.3.9 

func Parse(data any) (Element, error)

Parse attempts to convert a value into a Form. Currently supports map[string]any, []byte, string, and UnmarshalMaper interface.

func (*Element) AllElements added in v0.9.1 

func (element *Element) AllElements() []*Element

AllPaths returns pointers to all of the valid paths in this form

func (*Element) Edit added in v0.10.0 

func (element *Element) Edit(schema *schema.Schema, lookupProvider LookupProvider, value any, b *html.Builder) error

func (*Element) GetSliceOfString added in v0.9.1 

func (element *Element) GetSliceOfString(value any, s *schema.Schema) []string

func (*Element) GetString added in v0.9.1 

func (element *Element) GetString(value any, s *schema.Schema) string

GetValue returns the value of the element at the provided path. If the schema is present, then it is used to resolve the value. If the schema is not present, then the value is returned using path lookup instead.

func (*Element) UnmarshalMap added in v0.9.1 

func (element *Element) UnmarshalMap(data map[string]any) error

UnmarshalMap parses data from a generic structure (mapof.Any) into a Form record.

func (*Element) View added in v0.10.0 

func (element *Element) View(schema *schema.Schema, lookupProvider LookupProvider, value any, b *html.Builder) error

func (*Element) Widget added in v0.10.0 

func (element *Element) Widget() (Widget, error)

type Form 

type Form struct {
	Schema  schema.Schema
	Element Element
}

func New 

func New(schema schema.Schema, element Element) Form

New returns a fully initialized Form object (with all required values)

func (*Form) BuildEditor added in v0.10.0 

func (form *Form) BuildEditor(value any, lookupProvider LookupProvider, builder *html.Builder) error

BuildEditor generates an editable view of this form

func (*Form) BuildViewer added in v0.10.0 

func (form *Form) BuildViewer(value any, lookupProvider LookupProvider, builder *html.Builder) error

BuildViewer generates a read-only view of this form

func (*Form) Editor added in v0.10.0 

func (form *Form) Editor(value any, lookupProvider LookupProvider) (string, error)

DrawString() generates this form as a string

func (*Form) SetAll added in v0.13.1 

func (form *Form) SetAll(object any, value mapof.Any, lookupProvider LookupProvider) error

Do applies all of the data from the value map into the target object

func (*Form) Viewer added in v0.10.0 

func (form *Form) Viewer(value any, lookupProvider LookupProvider) (string, error)

DrawString() generates this form as a string

type LookupCode added in v0.9.1 

type LookupCode struct {
	Value       string `json:"value,omitempty"        form:"value"       bson:"value,omitempty"`       // Internal value of the LookupCode
	Label       string `json:"label,omitempty"        form:"label"       bson:"label,omitempty"`       // Human-friendly label/name of the LookupCode
	Description string `json:"description,omitempty"  form:"description" bson:"description,omitempty"` // Optional long description of the LookupCode
	Icon        string `json:"icon,omitempty"         form:"icon"        bson:"icon,omitempty"`        // Optional icon to use when displaying the LookupCode
	Group       string `json:"group,omitempty"        form:"group"       bson:"group,omitempty"`       // Optiional grouping to use when displaying the LookupCode
}

LookupCode represents a single value/label pair to be used in place of Enums for optional lists.

func AsLookupCode added in v0.16.0 

func AsLookupCode[T LookupCodeMaker](maker T) LookupCode

AsLookupCode is a helper function that converts any object that implements the LookupCodeMaker interface into a form.LookupCode

func GetLookupCodes added in v0.9.1 

func GetLookupCodes(element *Element, schemaElement schema.Element, lookupProvider LookupProvider) ([]LookupCode, bool)

GetLookupCodes returns a list of LookupCodes derived from: 1) an "enum" (string or slice-of-lookupCode) in the form element, 2) a "datasource" value that is looked up in the lookupProvider 3) a value enumerated in the schema

The boolean value is TRUE if this comes from a WritableLookupGroup

func NewLookupCode added in v0.9.1 

func NewLookupCode(value string) LookupCode

NewLookupCode creates a new LookupCode from a string

func ParseLookupCode added in v0.15.2 

func ParseLookupCode(value any) LookupCode

func (*LookupCode) GetPointer added in v0.15.5 

func (lookupCode *LookupCode) GetPointer(name string) (any, bool)

func (LookupCode) ID added in v0.12.0 

func (lookupCode LookupCode) ID() string

ID returns the unique ID of the LookupCode, allowing them to be used as a set.Value

type LookupCodeMaker added in v0.16.0 

type LookupCodeMaker interface {
	// LookupCode returns the data from current object in the form of a form.LookupCode
	LookupCode() LookupCode
}

LookupCodeMaker is an interface that wraps the LookupCode method

type LookupGroup added in v0.13.1 

type LookupGroup interface {
	Get() []LookupCode
}

type LookupProvider added in v0.9.1 

type LookupProvider interface {
	Group(name string) LookupGroup
}

OptionProvider is an external object that can inject LookupCodes based on their URL.

type ReadOnlyLookupGroup added in v0.13.1 

type ReadOnlyLookupGroup []LookupCode

ReadOnlyLookupGroup is a simple implementation of LookupGroup that returns a static list of LookupCodes.

func NewReadOnlyLookupGroup added in v0.13.1 

func NewReadOnlyLookupGroup(codes ...LookupCode) ReadOnlyLookupGroup

func (ReadOnlyLookupGroup) Get added in v0.13.1 

func (group ReadOnlyLookupGroup) Get() []LookupCode

type Rule added in v0.6.0 

type Rule struct {
	Path  string `json:"path"`
	Op    string `json:"op"`
	Value string `json:"value"`
}

func (Rule) HyperscriptRules added in v0.6.0 

func (rule Rule) HyperscriptRules() string

func (Rule) IsEmpty added in v0.6.0 

func (rule Rule) IsEmpty() bool

func (Rule) Operator added in v0.6.0 

func (rule Rule) Operator() string

type UnmarshalMaper added in v0.6.4 

type UnmarshalMaper interface {

	// UnmarshalMap returns a value in the format map[string]interface
	UnmarshalMap() map[string]any
}

UnmarshalMaper wraps the UnmarshalMap interface

type Widget added in v0.10.0 

type Widget interface {
	View(element *Element, schema *schema.Schema, lookupProvider LookupProvider, value any, builder *html.Builder) error
	Edit(element *Element, schema *schema.Schema, lookupProvider LookupProvider, value any, builder *html.Builder) error
	ShowLabels() bool
}

type WidgetCheckbox added in v0.10.0 

type WidgetCheckbox struct{}

func (WidgetCheckbox) Edit added in v0.10.0 

func (widget WidgetCheckbox) Edit(element *Element, s *schema.Schema, lookupProvider LookupProvider, value any, b *html.Builder) error

func (WidgetCheckbox) ShowLabels added in v0.10.0 

func (WidgetCheckbox) ShowLabels() bool

func (WidgetCheckbox) View added in v0.10.0 

func (widget WidgetCheckbox) View(element *Element, schema *schema.Schema, lookupProvider LookupProvider, value any, b *html.Builder) error

type WidgetHeading added in v0.15.2 

type WidgetHeading struct{}

func (WidgetHeading) Edit added in v0.15.2 

func (WidgetHeading) Edit(element *Element, s *schema.Schema, lookupProvider LookupProvider, value any, b *html.Builder) error

func (WidgetHeading) ShowLabels added in v0.15.2 

func (WidgetHeading) ShowLabels() bool

func (WidgetHeading) View added in v0.15.2 

func (WidgetHeading) View(element *Element, s *schema.Schema, lookupProvider LookupProvider, value any, b *html.Builder) error

type WidgetHidden added in v0.10.0 

type WidgetHidden struct{}

func (WidgetHidden) Edit added in v0.10.0 

func (WidgetHidden) Edit(element *Element, s *schema.Schema, lookupProvider LookupProvider, value any, b *html.Builder) error

WidgetHidden registers a text <input> widget into the library

func (WidgetHidden) ShowLabels added in v0.10.0 

func (WidgetHidden) ShowLabels() bool

func (WidgetHidden) View added in v0.10.0 

func (WidgetHidden) View(element *Element, schema *schema.Schema, lookupProvider LookupProvider, value any, b *html.Builder) error

type WidgetLabel added in v0.15.2 

type WidgetLabel struct{}

func (WidgetLabel) Edit added in v0.15.2 

func (WidgetLabel) Edit(element *Element, s *schema.Schema, lookupProvider LookupProvider, value any, b *html.Builder) error

func (WidgetLabel) ShowLabels added in v0.15.2 

func (WidgetLabel) ShowLabels() bool

func (WidgetLabel) View added in v0.15.2 

func (WidgetLabel) View(element *Element, s *schema.Schema, lookupProvider LookupProvider, value any, b *html.Builder) error

type WidgetLayoutGroup added in v0.10.0 

type WidgetLayoutGroup struct{}

func (WidgetLayoutGroup) Edit added in v0.10.0 

func (WidgetLayoutGroup) Edit(element *Element, schema *schema.Schema, lookupProvider LookupProvider, value any, b *html.Builder) error

func (WidgetLayoutGroup) ShowLabels added in v0.10.0 

func (WidgetLayoutGroup) ShowLabels() bool

func (WidgetLayoutGroup) View added in v0.10.0 

func (WidgetLayoutGroup) View(element *Element, schema *schema.Schema, lookupProvider LookupProvider, value any, b *html.Builder) error

type WidgetLayoutHorizontal added in v0.10.0 

type WidgetLayoutHorizontal struct{}

func (WidgetLayoutHorizontal) Edit added in v0.10.0 

func (WidgetLayoutHorizontal) Edit(element *Element, s *schema.Schema, lookupProvider LookupProvider, value any, b *html.Builder) error

func (WidgetLayoutHorizontal) ShowLabels added in v0.10.0 

func (WidgetLayoutHorizontal) ShowLabels() bool

func (WidgetLayoutHorizontal) View added in v0.10.0 

func (WidgetLayoutHorizontal) View(element *Element, s *schema.Schema, lookupProvider LookupProvider, value any, b *html.Builder) error

type WidgetLayoutTabs added in v0.10.0 

type WidgetLayoutTabs struct{}

func (WidgetLayoutTabs) Edit added in v0.10.0 

func (WidgetLayoutTabs) Edit(element *Element, s *schema.Schema, lookupProvider LookupProvider, value any, b *html.Builder) error

func (WidgetLayoutTabs) ShowLabels added in v0.10.0 

func (WidgetLayoutTabs) ShowLabels() bool

func (WidgetLayoutTabs) View added in v0.10.0 

func (WidgetLayoutTabs) View(element *Element, s *schema.Schema, lookupProvider LookupProvider, value any, b *html.Builder) error

type WidgetLayoutVertical added in v0.10.0 

type WidgetLayoutVertical struct{}

func (WidgetLayoutVertical) Edit added in v0.10.0 

func (WidgetLayoutVertical) Edit(element *Element, s *schema.Schema, lookupProvider LookupProvider, value any, b *html.Builder) error

func (WidgetLayoutVertical) ShowLabels added in v0.10.0 

func (WidgetLayoutVertical) ShowLabels() bool

func (WidgetLayoutVertical) View added in v0.10.0 

func (WidgetLayoutVertical) View(element *Element, s *schema.Schema, lookupProvider LookupProvider, value any, b *html.Builder) error

type WidgetMultiselect added in v0.10.0 

type WidgetMultiselect struct{}

func (WidgetMultiselect) Edit added in v0.10.0 

func (WidgetMultiselect) Edit(element *Element, s *schema.Schema, lookupProvider LookupProvider, value any, b *html.Builder) error

WidgetMultiselect registers a custom multi-select widget into the library

func (WidgetMultiselect) ShowLabels added in v0.10.0 

func (WidgetMultiselect) ShowLabels() bool

func (WidgetMultiselect) View added in v0.10.0 

func (WidgetMultiselect) View(element *Element, s *schema.Schema, lookupProvider LookupProvider, value any, b *html.Builder) error

type WidgetRadio added in v0.10.0 

type WidgetRadio struct{}

func (WidgetRadio) Edit added in v0.10.0 

func (WidgetRadio) Edit(element *Element, s *schema.Schema, lookupProvider LookupProvider, value any, b *html.Builder) error

func (WidgetRadio) ShowLabels added in v0.10.0 

func (WidgetRadio) ShowLabels() bool

func (WidgetRadio) View added in v0.10.0 

func (WidgetRadio) View(element *Element, s *schema.Schema, lookupProvider LookupProvider, value any, b *html.Builder) error

type WidgetSelect added in v0.10.0 

type WidgetSelect struct{}

WidgetSelect renders a select box widget

func (WidgetSelect) Edit added in v0.10.0 

func (WidgetSelect) Edit(element *Element, s *schema.Schema, lookupProvider LookupProvider, value any, b *html.Builder) error

func (WidgetSelect) ShowLabels added in v0.10.0 

func (WidgetSelect) ShowLabels() bool

func (WidgetSelect) View added in v0.10.0 

func (WidgetSelect) View(element *Element, s *schema.Schema, lookupProvider LookupProvider, value any, b *html.Builder) error

type WidgetText added in v0.10.0 

type WidgetText struct{}

func (WidgetText) Edit added in v0.10.0 

func (WidgetText) Edit(element *Element, s *schema.Schema, lookupProvider LookupProvider, value any, b *html.Builder) error

func (WidgetText) ShowLabels added in v0.10.0 

func (WidgetText) ShowLabels() bool

func (WidgetText) View added in v0.10.0 

func (WidgetText) View(element *Element, s *schema.Schema, lookupProvider LookupProvider, value any, b *html.Builder) error

type WidgetTextArea added in v0.10.0 

type WidgetTextArea struct{}

WidgetTextArea renders a long text <textarea> widget

func (WidgetTextArea) Edit added in v0.10.0 

func (WidgetTextArea) Edit(element *Element, s *schema.Schema, lookupProvider LookupProvider, value any, b *html.Builder) error

func (WidgetTextArea) ShowLabels added in v0.10.0 

func (WidgetTextArea) ShowLabels() bool

func (WidgetTextArea) View added in v0.10.0 

func (WidgetTextArea) View(element *Element, s *schema.Schema, lookupProvider LookupProvider, value any, b *html.Builder) error

type WidgetToggle added in v0.10.0 

type WidgetToggle struct{}

WidgetToggle renders a custom toggle widget

func (WidgetToggle) Edit added in v0.10.0 

func (WidgetToggle) Edit(element *Element, s *schema.Schema, lookupProvider LookupProvider, value any, b *html.Builder) error

func (WidgetToggle) ShowLabels added in v0.10.0 

func (WidgetToggle) ShowLabels() bool

func (WidgetToggle) View added in v0.10.0 

func (WidgetToggle) View(element *Element, s *schema.Schema, lookupProvider LookupProvider, value any, b *html.Builder) error

type WidgetWYSIWYG added in v0.10.0 

type WidgetWYSIWYG struct{}

func (WidgetWYSIWYG) Edit added in v0.10.0 

func (WidgetWYSIWYG) Edit(element *Element, s *schema.Schema, lookupProvider LookupProvider, value any, b *html.Builder) error

func (WidgetWYSIWYG) ShowLabels added in v0.10.0 

func (WidgetWYSIWYG) ShowLabels() bool

func (WidgetWYSIWYG) View added in v0.10.0 

func (WidgetWYSIWYG) View(element *Element, s *schema.Schema, lookupProvider LookupProvider, value any, b *html.Builder) error

type WritableLookupGroup added in v0.13.1 

type WritableLookupGroup interface {
	LookupGroup
	Add(name string) (string, error)
}

Source Files

View all Source files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.
JackTT - Gopher 🇻🇳