forms

package

Go to main page

Versions in this module

v1

v1.7.4

Jul 8, 2026

v1.7.3

Jul 8, 2026

v1.7.2

Jul 8, 2026

Changes in this version

+ const FormTemplateFSHookName

+ const FormTemplateStaticHookName

+ func FullClean(ctx context.Context, f Form) (invalid, defaults, cleaned map[string]any)

+ func HasErrors(form ErrorDefiner) bool

+ func IsValid[T any](ctx context.Context, f T) bool

+ func ValueFromDataDict[T any](ctx context.Context, form FormFieldDefiner, name string, ...) (T, bool, []error)

+ type BaseBoundForm struct

+ BoundFieldMap map[string]BoundField

+ BoundFields []BoundField

+ ErrorMap *orderedmap.OrderedMap[string, []error]

+ Form FormBinder

+ ListErrors []error

+ func (f *BaseBoundForm) AsP() template.HTML

+ func (f *BaseBoundForm) AsTable() template.HTML

+ func (f *BaseBoundForm) AsUL() template.HTML

+ func (f *BaseBoundForm) ErrorList() []error

+ func (f *BaseBoundForm) Errors() *orderedmap.OrderedMap[string, []error]

+ func (f *BaseBoundForm) FieldMap() map[string]BoundField

+ func (f *BaseBoundForm) Fields() []BoundField

+ func (f *BaseBoundForm) Media() media.Media

+ func (f *BaseBoundForm) UnpackErrors() []FieldError

type BaseForm

+ FormContext context.Context

+ FormRenderer FormRenderer

+ FormValidators []func(Form, map[string]interface{}) []error

+ func (f *BaseForm) BindCleanedData(invalid, defaults, cleaned map[string]interface{})

+ func (f *BaseForm) CallbackOnFinalize() []func(Form)

+ func (f *BaseForm) CallbackOnInvalid() []func(Form)

+ func (f *BaseForm) CallbackOnValid() []func(Form)

+ func (f *BaseForm) CleanedDataUnsafe() map[string]interface{}

+ func (f *BaseForm) Context() context.Context

+ func (f *BaseForm) Data() (url.Values, map[string][]filesystem.FileHeader)

+ func (f *BaseForm) FieldMap() *orderedmap.OrderedMap[string, Field]

+ func (f *BaseForm) PrefixName(name string) string

+ func (f *BaseForm) Renderer() FormRenderer

+ func (f *BaseForm) SetRenderer(renderer FormRenderer)

+ func (f *BaseForm) WasCleaned() bool

+ func (f *BaseForm) WithContext(ctx context.Context)

+ type BinderWidget = forms.BinderWidget

type BoundForm

+ func NewBoundForm(ctx context.Context, f FormBinder, renderer FormRenderer) BoundForm

type BoundFormField

+ FormContext context.Context

+ FormID string

+ Renderer FormRenderer

+ func (b *BoundFormField) Context() context.Context

+ func (b *BoundFormField) Hidden() bool

+ type ErrorDefiner = forms.ErrorDefiner

+ type ErrorUnpacker interface

+ UnpackErrors func(boundForm BoundForm, boundErrors *orderedmap.OrderedMap[string, []error]) []FieldError

+ type Field = forms.Field

type FieldError

+ func UnpackErrors[T interface{ ... }](bf BoundForm, f FormBinder, errorMap *orderedmap.OrderedMap[string, []error], ...) []FieldError

+ type FormBinder interface

+ BoundFields func() *orderedmap.OrderedMap[string, BoundField]

+ Context func() context.Context

+ FieldOrder func() []string

+ type FormFieldDefiner = forms.FormFieldDefiner

+ type FormTemplateFSHook func(fSys fs.FS, cnf *tpl.Config) fs.FS

+ type FormTemplateStaticHook func(fSys fs.FS) fs.FS

+ type FormValueConverter = forms.FormValueConverter

+ type FormValueGetter = forms.FormValueGetter

+ type FormValueOmitter = forms.FormValueOmitter

+ type FormValuer = forms.FormValuer

+ type FormWrapper = forms.FormWrapper[T]

+ type FullCleanMixin = forms.FullCleanMixin

+ type IsValidDefiner = forms.IsValidDefiner

+ type Option = forms.Option

+ type PrevalidatorMixin = forms.PrevalidatorMixin

+ type ValidatorMixin = forms.ValidatorMixin

+ type Widget = forms.Widget

+ type WithDataDefiner = forms.WithDataDefiner

v1.7.0

May 12, 2025

v1.6.9

Dec 20, 2024

v1.6.8

Nov 12, 2024

Changes in this version

type BaseForm

+ func (f *BaseForm) Save() (map[string]interface{}, error)

+ type SaveableForm interface

+ Save func() (map[string]interface{}, error)

v1.6.7

Nov 6, 2024

v1.6.6

Oct 17, 2024

Changes in this version

+ func InitTemplateLibrary()

v1.6.5

Oct 7, 2024

Changes in this version

+ func Initialize[T Form](f T, initfuncs ...func(Form)) T

+ func OnFinalize(funcs ...func(Form)) func(Form)

+ func OnInvalid(funcs ...func(Form)) func(Form)

+ func OnValid(funcs ...func(Form)) func(Form)

+ func WithData(data url.Values, files map[string][]filesystem.FileHeader, r *http.Request) func(Form)

+ func WithFields(fields ...fields.Field) func(Form)

+ func WithInitial(initial map[string]interface{}) func(Form)

+ func WithPrefix(prefix string) func(Form)

+ func WithRequestData(method string, r *http.Request) func(Form)

+ type BaseForm struct

+ Cleaned map[string]interface{}

+ Defaults map[string]interface{}

+ ErrorList_ []error

+ Errors *orderedmap.OrderedMap[string, []error]

+ Files map[string][]filesystem.FileHeader

+ FormFields *orderedmap.OrderedMap[string, fields.Field]

+ FormPrefix string

+ FormWidgets *orderedmap.OrderedMap[string, widgets.Widget]

+ Initial map[string]interface{}

+ InvalidDefaults map[string]interface{}

+ OnFinalizeFuncs []func(Form)

+ OnInvalidFuncs []func(Form)

+ OnValidFuncs []func(Form)

+ Raw url.Values

+ Validators []func(Form) []error

+ func NewBaseForm(opts ...func(Form)) *BaseForm

+ func (f *BaseForm) AddError(name string, errorList ...error)

+ func (f *BaseForm) AddField(name string, field fields.Field)

+ func (f *BaseForm) AddFormError(errorList ...error)

+ func (f *BaseForm) AddWidget(name string, widget widgets.Widget)

+ func (f *BaseForm) AsP() template.HTML

+ func (f *BaseForm) AsUL() template.HTML

+ func (f *BaseForm) BoundErrors() *orderedmap.OrderedMap[string, []error]

+ func (f *BaseForm) BoundFields() *orderedmap.OrderedMap[string, BoundField]

+ func (f *BaseForm) BoundForm() BoundForm

+ func (f *BaseForm) CleanedData() map[string]interface{}

+ func (f *BaseForm) DeleteField(name string) bool

+ func (f *BaseForm) EditContext(key string, context ctx.Context)

+ func (f *BaseForm) ErrorList() []error

+ func (f *BaseForm) Field(name string) (fields.Field, bool)

+ func (f *BaseForm) FieldOrder() []string

+ func (f *BaseForm) Fields() []fields.Field

+ func (f *BaseForm) FormValue(name string) interface{}

+ func (f *BaseForm) FullClean()

+ func (f *BaseForm) HasChanged() bool

+ func (f *BaseForm) InitialData() map[string]interface{}

+ func (f *BaseForm) IsValid() bool

+ func (f *BaseForm) Media() media.Media

+ func (f *BaseForm) OnFinalize(funcs ...func(Form))

+ func (f *BaseForm) OnInvalid(funcs ...func(Form))

+ func (f *BaseForm) OnValid(funcs ...func(Form))

+ func (f *BaseForm) Ordering(order []string)

+ func (f *BaseForm) Prefix() string

+ func (f *BaseForm) Reset()

+ func (f *BaseForm) SetInitial(initial map[string]interface{})

+ func (f *BaseForm) SetPrefix(prefix string)

+ func (f *BaseForm) SetValidators(validators ...func(Form) []error)

+ func (f *BaseForm) Validate()

+ func (f *BaseForm) Widget(name string) (widgets.Widget, bool)

+ func (f *BaseForm) Widgets() []widgets.Widget

+ func (f *BaseForm) WithData(data url.Values, files map[string][]filesystem.FileHeader, r *http.Request) Form

+ type BaseFormset struct

+ MainForm Form

+ MaxNum int

+ MinNum int

+ type BoundField interface

+ Attrs func() map[string]string

+ Errors func() []error

+ Field func() template.HTML

+ HTML func() template.HTML

+ HelpText func() template.HTML

+ ID func() string

+ Input func() fields.Field

+ Label func() template.HTML

+ Name func() string

+ Value func() interface{}

+ Widget func() widgets.Widget

+ func NewBoundFormField(w widgets.Widget, f fields.Field, name string, value interface{}, ...) BoundField

+ type BoundForm interface

+ AsP func() template.HTML

+ AsUL func() template.HTML

+ ErrorList func() []error

+ Errors func() *orderedmap.OrderedMap[string, []error]

+ Fields func() []BoundField

+ Media func() media.Media

+ UnpackErrors func() []FieldError

+ type BoundFormField struct

+ CachedHTML template.HTML

+ FormAttrs map[string]string

+ FormErrors []error

+ FormField fields.Field

+ FormName string

+ FormValue interface{}

+ FormWidget widgets.Widget

+ func (b *BoundFormField) Attrs() map[string]string

+ func (b *BoundFormField) Errors() []error

+ func (b *BoundFormField) Field() template.HTML

+ func (b *BoundFormField) HTML() template.HTML

+ func (b *BoundFormField) HelpText() template.HTML

+ func (b *BoundFormField) ID() string

+ func (b *BoundFormField) Input() fields.Field

+ func (b *BoundFormField) Label() template.HTML

+ func (b *BoundFormField) Name() string

+ func (b *BoundFormField) Value() interface{}

+ func (b *BoundFormField) Widget() widgets.Widget

+ type Cleaner interface

+ Clean func(value interface{}) (interface{}, error)

+ type ErrorAdder interface

+ AddError func(name string, errorList ...error)

+ AddFormError func(errorList ...error)

+ type FieldError interface

+ Errors func() []error

+ Field func() string

+ type Form interface

+ AddField func(name string, field fields.Field)

+ AddWidget func(name string, widget widgets.Widget)

+ BoundErrors func() *orderedmap.OrderedMap[string, []error]

+ BoundFields func() *orderedmap.OrderedMap[string, BoundField]

+ BoundForm func() BoundForm

+ CleanedData func() map[string]interface{}

+ DeleteField func(name string) bool

+ ErrorList func() []error

+ Field func(name string) (fields.Field, bool)

+ FieldOrder func() []string

+ Fields func() []fields.Field

+ FullClean func()

+ HasChanged func() bool

+ InitialData func() map[string]interface{}

+ IsValid func() bool

+ OnFinalize func(...func(Form))

+ OnInvalid func(...func(Form))

+ OnValid func(...func(Form))

+ Ordering func([]string)

+ Prefix func() string

+ SetInitial func(initial map[string]interface{})

+ SetPrefix func(prefix string)

+ SetValidators func(validators ...func(Form) []error)

+ Validate func()

+ Widget func(name string) (widgets.Widget, bool)

+ Widgets func() []widgets.Widget

+ WithData func(data url.Values, files map[string][]filesystem.FileHeader, r *http.Request) Form

+ type FormRenderer interface

+ AsP func() template.HTML

+ AsUL func() template.HTML

+ Media func() media.Media

+ type Validator interface

+ Validate func(value interface{}) []error

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL