form

type AddOn struct {
	// The HTML node to use as addon
	Node *html.Node
	// The addon position
	Position AddOnPosition
}

type AddOnPosition int

type AddOnProvider interface {
	// FieldAddOns returns the addons for the given field.
	// It's called just before the field is rendered.
	FieldAddOns(ctx *app.Context, field *Field) []*AddOn
}

type Choice struct {
	// Name must be either a string or an i18n.String
	// or a fmt.Stringer.
	// Other types will panic when rendering the form.
	Name  interface{}
	Value interface{}
}

type ChoicesProvider interface {
	// FieldChoices returns the choices for the given field.
	// It's called just before the field is rendered.
	FieldChoices(ctx *app.Context, field *Field) []*Choice
}

type Field struct {
	Type        Type
	Name        string
	HTMLName    string
	Label       i18n.String
	Placeholder i18n.String
	Help        i18n.String
	// contains filtered or unexported fields
}

type File []interface{}

type Form struct {

	// Don't include the field name in the error
	NamelessErrors bool
	// DisableCSRF disables CSRF protection when set
	// to true. Note that changing this after the
	// form has been rendered or validated has no effect.
	DisableCSRF bool
	// contains filtered or unexported fields
}

type Options struct {
	// Render is the type which renders the form. If Renderer
	// is nil, DefaultRenderer() is used to obtain a new Renderer.
	// When writing a reusable package or app, is recommended to always
	// leave this field with a nil value, so the app user can import
	// a package which redefines the default Renderer to use the
	// frontend framework used in the final app
	// (like e.g. gnd.la/bootstrap/form).
	Renderer Renderer
	// Fields lists the struct fields to include in the form. If empty,
	// all exported fields are included.
	Fields []string
}

type Renderer interface {
	// BeginField is called before starting to write any field.
	BeginField(w io.Writer, field *Field) error
	// BeginLabel is called before writing the label. It might be
	// called multiple times for radio fields. Renderers should use
	// the provided label string rather than the Label field on the
	// Field struct, because the former is already translated.
	BeginLabel(w io.Writer, field *Field, label string, pos int) error
	// LabelAttributes is called just before writing the <label> for the field.
	LabelAttributes(field *Field, pos int) (html.Attrs, error)
	// EndLabel is called before writing the end of the label. It might be
	// called multiple times for radio fields.
	EndLabel(w io.Writer, field *Field, pos int) error
	// BeginInput is called just before writing the <input> or equivalent tag
	// or any addons. For radio fields BeginInput will be called multiple times,
	// one per option. Renders should use the provided placeholder string
	// rather than the Placeholder field in the Field struct, because the
	// former is already translated.
	BeginInput(w io.Writer, field *Field, placeholder string, pos int) error
	// FieldAttributes is called just before writing the field (input, textarea, etc...)
	FieldAttributes(field *Field, pos int) (html.Attrs, error)
	// EndInput is called just after writing the <input> or equivalent tag and
	// all the addons. For radio fields EndInput will be called multiple times,
	// one per option.
	EndInput(w io.Writer, field *Field, pos int) error
	// WriteAddOn might be called multiple times, both before writing the field
	// and after (depending on the addons' positions). All these calls will happen
	// after BeginInput() and EndInput().
	WriteAddOn(w io.Writer, field *Field, addon *AddOn) error
	// WriteError is called only for fields which are in not valid, after
	// the label and the input have been written. err is translated before the
	// function is called.
	WriteError(w io.Writer, field *Field, err error) error
	// WriteHelp is called only for fields which have declared a help string, after
	// the label, the input and potentially the error have been written.
	// Renderers should use the provided help string rather than the Help field on the
	// Field struct, because the former is already translated.
	WriteHelp(w io.Writer, field *Field, help string) error
	// EndField is called after all the other field related functions have been called.
	EndField(w io.Writer, field *Field) error
}

type Type int