Why Go
- Case Studies
  
  Common problems companies solve with Go
- Use Cases
  
  Stories about how and why companies use Go
- Security
  
  How Go can help keep you secure by default
Learn
Docs
- Effective Go
  
  Tips for writing clear, performant, and idiomatic Go code
- Go User Manual
  
  A complete introduction to building software with Go
- Standard library
  
  Reference documentation for Go's standard library
- Release Notes
  
  Learn what's new in each Go release
Packages
Community
- Recorded Talks
  
  Videos from prior events
- Meetups
  
  Meet other local Go developers
- Conferences
  
  Learn and network with Go developers from around the world
- Go blog
  
  The Go project's official blog.
- Go project
  
  Get help and stay informed from Go
- Get connected

form

package module

Go to main page

Versions in this module

v0

v0.20.0

Feb 11, 2026

Changes in this version

+ const FORM_FIELD_TYPE_CHECKBOX

+ const FORM_FIELD_TYPE_COLOR

+ const FORM_FIELD_TYPE_EMAIL

+ const FORM_FIELD_TYPE_FILE

+ const FORM_FIELD_TYPE_RADIO

+ const FORM_FIELD_TYPE_TEL

+ const FORM_FIELD_TYPE_URL

+ func AssertFieldContains(t *testing.T, field FieldInterface, expected string)

+ func AssertFieldNotContains(t *testing.T, field FieldInterface, unexpected string)

+ func AssertFormContains(t *testing.T, form *Form, expected string)

+ func AssertFormNotContains(t *testing.T, form *Form, unexpected string)

+ func AssertValidationErrorCount(t *testing.T, form *Form, values map[string]string, expectedCount int)

+ func AssertValidationFailsOn(t *testing.T, form *Form, values map[string]string, fieldName string)

+ func AssertValidationPasses(t *testing.T, form *Form, values map[string]string)

+ func NewFieldRow(fields ...FieldInterface) *fieldRow

+ func NewFieldRowWithColumns(columns ...FieldRowColumn) *fieldRow

type Field

+ Attrs map[string]string

+ Multiple bool

+ Validators []Validator

+ func NewCheckboxField(name, label string) *Field

+ func NewColorField(name, label string) *Field

+ func NewDateField(name, label string) *Field

+ func NewDateTimeField(name, label string) *Field

+ func NewEmailField(name, label string) *Field

+ func NewFileField(name, label string) *Field

+ func NewHiddenField(name, value string) *Field

+ func NewHtmlAreaField(name, label string) *Field

+ func NewImageField(name, label string) *Field

+ func NewNumberField(name, label string) *Field

+ func NewPasswordField(name, label string) *Field

+ func NewRadioField(name, label string, options []FieldOption) *Field

+ func NewRawField(value string) *Field

+ func NewSelectField(name, label string, options []FieldOption) *Field

+ func NewStringField(name, label string) *Field

+ func NewTelField(name, label string) *Field

+ func NewTextAreaField(name, label string) *Field

+ func NewURLField(name, label string) *Field

+ func (field *Field) IsCheckbox() bool

+ func (field *Field) IsColor() bool

+ func (field *Field) IsEmail() bool

+ func (field *Field) IsFile() bool

+ func (field *Field) IsRadio() bool

+ func (field *Field) IsTel() bool

+ func (field *Field) IsUrl() bool

+ func (field *Field) WithAttr(key, value string) *Field

+ func (field *Field) WithAttrs(attrs map[string]string) *Field

+ func (field *Field) WithCustomInput(input hb.TagInterface) *Field

+ func (field *Field) WithDisabled() *Field

+ func (field *Field) WithHelp(help string) *Field

+ func (field *Field) WithID(id string) *Field

+ func (field *Field) WithInvisible() *Field

+ func (field *Field) WithLabel(label string) *Field

+ func (field *Field) WithMultiple() *Field

+ func (field *Field) WithName(name string) *Field

+ func (field *Field) WithOptions(options ...FieldOption) *Field

+ func (field *Field) WithOptionsF(optionsF func() []FieldOption) *Field

+ func (field *Field) WithPlaceholder(placeholder string) *Field

+ func (field *Field) WithReadonly() *Field

+ func (field *Field) WithRequired() *Field

+ func (field *Field) WithTableOptions(opts TableOptions) *Field

+ func (field *Field) WithType(fieldType string) *Field

+ func (field *Field) WithValidators(validators ...Validator) *Field

+ func (field *Field) WithValue(value string) *Field

type FieldOptions

+ Attrs map[string]string

+ Multiple bool

+ Validators []Validator

+ type FieldRowColumn struct

+ ColClass string

+ Field FieldInterface

type Form

+ func New() *Form

+ func (form *Form) GetErrors() map[string]string

+ func (form *Form) SetErrors(errors map[string]string)

+ func (form *Form) Validate(values map[string]string) []ValidationError

+ func (form *Form) WithAction(actionURL string) *Form

+ func (form *Form) WithClass(className string) *Form

+ func (form *Form) WithErrors(errors map[string]string) *Form

+ func (form *Form) WithFields(fields ...FieldInterface) *Form

+ func (form *Form) WithFileManager(url string) *Form

+ func (form *Form) WithHTMX(config HTMXConfig) *Form

+ func (form *Form) WithHxPost(url string) *Form

+ func (form *Form) WithHxSwap(swap string) *Form

+ func (form *Form) WithHxTarget(target string) *Form

+ func (form *Form) WithID(id string) *Form

+ func (form *Form) WithMethod(method string) *Form

+ func (form *Form) WithTheme(theme *Theme) *Form

+ type HTMXConfig struct

+ Confirm string

+ DisabledElt string

+ Encoding string

+ Get string

+ Indicator string

+ Post string

+ PushURL string

+ Swap string

+ Sync string

+ Target string

+ Trigger string

+ Validate bool

+ type Theme struct

+ CheckboxInputClass string

+ CheckboxWrapClass string

+ ErrorClass string

+ ErrorInputClass string

+ FileInputClass string

+ FormGroupClass string

+ HelpClass string

+ InputClass string

+ LabelClass string

+ RadioInputClass string

+ RadioLabelClass string

+ RadioWrapClass string

+ RequiredClass string

+ RequiredMarker string

+ SelectClass string

+ TableClass string

+ TextAreaClass string

+ func ThemeBootstrap5() *Theme

+ func ThemeTailwind() *Theme

+ type ValidationError struct

+ Field string

+ Message string

+ func AssertValidationFails(t *testing.T, form *Form, values map[string]string) []ValidationError

+ type Validator func(fieldName string, value string) *ValidationError

+ func ValidatorAlphaNumeric() Validator

+ func ValidatorCustom(fn func(value string) string) Validator

+ func ValidatorEmail() Validator

+ func ValidatorIP() Validator

+ func ValidatorMax(max float64) Validator

+ func ValidatorMaxLength(maxLength int) Validator

+ func ValidatorMin(min float64) Validator

+ func ValidatorMinLength(minLength int) Validator

+ func ValidatorOneOf(allowed ...string) Validator

+ func ValidatorPattern(pattern string, message string) Validator

+ func ValidatorRequired() Validator

+ func ValidatorURL() Validator

+ func ValidatorUUID() Validator

v0.19.0

Sep 1, 2025

v0.18.0

Sep 1, 2025

Changes in this version

+ const FORM_FIELD_TYPE_BLOCKEDITOR

+ const FORM_FIELD_TYPE_DATE

+ const FORM_FIELD_TYPE_DATETIME

+ const FORM_FIELD_TYPE_HIDDEN

+ const FORM_FIELD_TYPE_HTMLAREA

+ const FORM_FIELD_TYPE_IMAGE

+ const FORM_FIELD_TYPE_NUMBER

+ const FORM_FIELD_TYPE_PASSWORD

+ const FORM_FIELD_TYPE_RAW

+ const FORM_FIELD_TYPE_SELECT

+ const FORM_FIELD_TYPE_STRING

+ const FORM_FIELD_TYPE_TABLE

+ const FORM_FIELD_TYPE_TEXTAREA

+ func NewRepeater(opts RepeaterOptions) *fieldRepeater

+ type Field struct

+ CustomInput hb.TagInterface

+ Disabled bool

+ Help string

+ ID string

+ Invisible bool

+ Label string

+ Name string

+ Options []FieldOption

+ OptionsF func() []FieldOption

+ Placeholder string

+ Readonly bool

+ Required bool

+ TableOptions TableOptions

+ Type string

+ Value string

+ func NewField(opts FieldOptions) *Field

+ func (field *Field) BuildFormGroup(fileManagerURL string) *hb.Tag

+ func (field *Field) GetHelp() string

+ func (field *Field) GetID() string

+ func (field *Field) GetLabel() string

+ func (field *Field) GetName() string

+ func (field *Field) GetOptions() []FieldOption

+ func (field *Field) GetOptionsF() func() []FieldOption

+ func (field *Field) GetRequired() bool

+ func (field *Field) GetType() string

+ func (field *Field) GetValue() string

+ func (field *Field) IsBlockEditor() bool

+ func (field *Field) IsDate() bool

+ func (field *Field) IsDateTime() bool

+ func (field *Field) IsDisabled() bool

+ func (field *Field) IsHidden() bool

+ func (field *Field) IsHtmlArea() bool

+ func (field *Field) IsImage() bool

+ func (field *Field) IsNumber() bool

+ func (field *Field) IsPassword() bool

+ func (field *Field) IsRaw() bool

+ func (field *Field) IsReadonly() bool

+ func (field *Field) IsRequired() bool

+ func (field *Field) IsSelect() bool

+ func (field *Field) IsString() bool

+ func (field *Field) IsTable() bool

+ func (field *Field) IsTextArea() bool

+ func (field *Field) SetHelp(fieldHelp string)

+ func (field *Field) SetID(fieldID string)

+ func (field *Field) SetLabel(fieldLabel string)

+ func (field *Field) SetName(fieldName string)

+ func (field *Field) SetOptions(fieldOptions []FieldOption)

+ func (field *Field) SetOptionsF(fieldOptionsF func() []FieldOption)

+ func (field *Field) SetRequired(fieldRequired bool)

+ func (field *Field) SetType(fieldType string)

+ func (field *Field) SetValue(fieldValue string)

+ func (field *Field) TrumbowygScript() string

+ type FieldInterface interface

+ BuildFormGroup func(fileManagerURL string) *hb.Tag

+ GetHelp func() string

+ GetID func() string

+ GetLabel func() string

+ GetName func() string

+ GetOptions func() []FieldOption

+ GetOptionsF func() func() []FieldOption

+ GetRequired func() bool

+ GetType func() string

+ GetValue func() string

+ SetHelp func(fieldName string)

+ SetID func(fieldID string)

+ SetLabel func(fieldLabel string)

+ SetName func(fieldName string)

+ SetOptions func(fieldOptions []FieldOption)

+ SetOptionsF func(fieldOptionsF func() []FieldOption)

+ SetRequired func(fieldRequired bool)

+ SetType func(fieldType string)

+ SetValue func(fieldValue string)

+ type FieldOption struct

+ Key string

+ Value string

+ type FieldOptions struct

+ CustomInput hb.TagInterface

+ Disabled bool

+ Help string

+ ID string

+ Invisible bool

+ Label string

+ Name string

+ Options []FieldOption

+ OptionsF func() []FieldOption

+ Placeholder string

+ Readonly bool

+ Required bool

+ TableOptions TableOptions

+ Type string

+ Value string

+ type Form struct

+ func NewForm(opts FormOptions) *Form

+ func (form *Form) AddField(field FieldInterface)

+ func (form *Form) Build() *hb.Tag

+ func (form *Form) GetFields() []FieldInterface

+ func (form *Form) GetFileManagerURL() string

+ func (form *Form) SetFields(fields []FieldInterface)

+ func (form *Form) SetFileManagerURL(url string)

+ type FormOptions struct

+ ActionURL string

+ ClassName string

+ Fields []FieldInterface

+ FileManagerURL string

+ HxPost string

+ HxSwap string

+ HxTarget string

+ ID string

+ Method string

+ type RepeaterOptions struct

+ Fields []FieldInterface

+ Help string

+ Label string

+ Name string

+ RepeaterAddUrl string

+ RepeaterMoveDownUrl string

+ RepeaterMoveUpUrl string

+ RepeaterRemoveUrl string

+ Type string

+ Value string

+ Values []map[string]string

+ type TableColumn struct

+ Label string

+ Width int

+ type TableOptions struct

+ Header []TableColumn

+ RowAddButton *hb.Tag

+ RowDeleteButton *hb.Tag

+ Rows [][]Field