forms

Documentation

Index

• Variables
• type Form
  • func New(data url.Values) *Form
  • func (f *Form) MatchesPattern(field string, pattern *regexp.Regexp)
  • func (f *Form) MaxLength(field string, d int)
  • func (f *Form) MinLength(field string, d int)
  • func (f *Form) PermittedValues(field string, opts ...string)
  • func (f *Form) Required(fields ...string)
  • func (f *Form) Valid() bool

Variables

var EmailRX = regexp.MustCompile("^[a-zA-Z0-9.!#$%&'*+\\/=?^_`{|}~-]+@[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?(?:\\.[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?)*$")

Use the regexp.MustCompile() function to parse a pattern and compile a regular expression for sanity checking the format of an email address. This returns a *regexp.Regexp object, or panics in the event of an error. Doing this once at runtime, and storing the compiled regular expression object in a variable, is more performant than re-compiling the pattern with every request.

Types

type Form

type Form struct {
	url.Values
	Errors errors
}

Create a custom Form struct, which anonymously embeds a url.Values object (to hold the form data) and an Errors field to hold any validation errors for the form data.

func New

func New(data url.Values) *Form

Define a New function to initialize a custom Form struct. Notice that this takes the form data as the parameter?

func (*Form) MatchesPattern

func (f *Form) MatchesPattern(field string, pattern *regexp.Regexp)

Implement a MatchesPattern method to check that a specific field in the form matches a regular expression. If the check fails then add the appropriate message to the form errors.

func (*Form) MaxLength

func (f *Form) MaxLength(field string, d int)

Implement a MaxLength method to check that a specific field in the form contains a maximum number of characters. If the check fails then add the appropriate message to the form errors.

func (*Form) MinLength

func (f *Form) MinLength(field string, d int)

Implement a MinLength method to check that a specific field in the form contains a minimum number of characters. If the check fails then add the appropriate message to the form errors.

func (*Form) PermittedValues

func (f *Form) PermittedValues(field string, opts ...string)

Implement a PermittedValues method to check that a specific field in the form matches one of a set of specific permitted values. If the check fails then add the appropriate message to the form errors.

func (*Form) Required

func (f *Form) Required(fields ...string)

Implement a Required method to check that specific fields in the form data are present and not blank. If any fields fail this check, add the appropriate message to the form errors.// appropriate message to the form errors.

func (*Form) Valid

func (f *Form) Valid() bool

Implement a Valid method which returns true if there are no errors.