https://github.com/semihs/goform

Golang web forms, html5 support, file upload, bind from interface, bind from request, map to struct, template support, validations, filters and build query support
https://github.com/semihs/goform

form go-file-upload go-form go-forms go-html5-forms golang golang-file-upload golang-form golang-web-forms html5-forms

Last synced: 13 days ago
JSON representation

Golang web forms, html5 support, file upload, bind from interface, bind from request, map to struct, template support, validations, filters and build query support

• Host: GitHub
• URL: https://github.com/semihs/goform
• Owner: semihs
• Created: 2017-04-29T10:19:17.000Z (almost 9 years ago)
• Default Branch: master
• Last Pushed: 2021-01-15T12:39:54.000Z (about 5 years ago)
• Last Synced: 2024-06-20T11:16:06.601Z (over 1 year ago)
• Topics: form, go-file-upload, go-form, go-forms, go-html5-forms, golang, golang-file-upload, golang-form, golang-web-forms, html5-forms
• Language: Go
• Homepage:
• Size: 46.9 KB
• Stars: 15
• Watchers: 3
• Forks: 3
• Open Issues: 2
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          
# GoForm (GoLang Web Forms)

Golang Web Forms validations, rendering and binding.

## Features

* HTML5 Support

* Bind From Interface

* Bind From Request

* Map to your struct

* Validation

* Build Query String

* Template

## Installation

```

go get github.com/semihs/goform

```

## Examples

See [examples](https://github.com/semihs/goform/tree/master/samples).

## Usage

### Make a form

```go

package main

import (

	"github.com/semihs/goform"

	"net/http"

	"text/template"

)

var view string = `

{{range .GetElements}}

  {{.Render}}

{{end}}

`

func main() {

	email := goform.NewEmailElement("email", "Email", []*goform.Attribute{}, []goform.ValidatorInterface{

		&goform.RequiredValidator{},

	}, []goform.FilterInterface{})

	password := goform.NewPasswordElement("password", "Password", []*goform.Attribute{}, []goform.ValidatorInterface{}, []goform.FilterInterface{})

	submit := goform.NewButtonElement("submit", "Login", []*goform.Attribute{})

	form := goform.NewGoForm()

	form.Add(email)

	form.Add(password)

	form.Add(submit)

	tpl, _ := template.New("tpl").Parse(view)

	http.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) {

		w.Header().Set("Content-Type", "text/html")

		if r.Method != "POST" {

			tpl.Execute(w, form)

			return

		}

		r.ParseForm()

		form.BindFromRequest(r)

		if !form.IsValid() {

			tpl.Execute(w, form)

			return

		}

	})

	http.ListenAndServe(":2626", nil)

}

```

### Bind From Request

```go

package main

import (

	"github.com/semihs/goform"

	"net/http"

	"text/template"

)

var view string = `

{{range .GetElements}}

  {{.Render}}

{{end}}

`

func main() {

	email := goform.NewEmailElement("email", "Email", []*goform.Attribute{}, []goform.ValidatorInterface{

		&goform.RequiredValidator{},

	}, []goform.FilterInterface{})

	password := goform.NewPasswordElement("password", "Password", []*goform.Attribute{}, []goform.ValidatorInterface{}, []goform.FilterInterface{})

	submit := goform.NewButtonElement("submit", "Login", []*goform.Attribute{})

	form := goform.NewGoForm()

	form.Add(email)

	form.Add(password)

	form.Add(submit)

	tpl, _ := template.New("tpl").Parse(view)

	http.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) {

		w.Header().Set("Content-Type", "text/html")

		if r.Method != "POST" {

			tpl.Execute(w, form)

			return

		}

		r.ParseForm()

		form.BindFromRequest(r)

		tpl.Execute(w, form)

		return

	})

	http.ListenAndServe(":2626", nil)

}

```

### Bind From Interface

```go

package main

import (

	"github.com/semihs/goform"

	"net/http"

	"text/template"

)

var view string = `

{{range .GetElements}}

  {{.Render}}

{{end}}

`

type YourInterface struct {

	Email    string

	Password string

}

func main() {

	email := goform.NewEmailElement("email", "Email", []*goform.Attribute{}, []goform.ValidatorInterface{

		&goform.RequiredValidator{},

	}, []goform.FilterInterface{})

	password := goform.NewPasswordElement("password", "Password", []*goform.Attribute{}, []goform.ValidatorInterface{}, []goform.FilterInterface{})

	submit := goform.NewButtonElement("submit", "Login", []*goform.Attribute{})

	form := goform.NewGoForm()

	form.Add(email)

	form.Add(password)

	form.Add(submit)

	tpl, _ := template.New("tpl").Parse(view)

	http.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) {

		w.Header().Set("Content-Type", "text/html")

		if r.Method != "POST" {

			s := YourInterface{

				Email:    "semihsari@gmail.com",

				Password: "password",

			}

			form.BindFromInterface(s)

			tpl.Execute(w, form)

			return

		}

	})

	http.ListenAndServe(":2626", nil)

}

```

### Map to your struct

```go

package main

import (

	"fmt"

	"github.com/semihs/goform"

	"net/http"

	"text/template"

)

var view string = `

{{range .GetElements}}

  {{.Render}}

{{end}}

`

type YourStruct struct {

	Email    string

	Password string

}

func main() {

	email := goform.NewEmailElement("email", "Email", []*goform.Attribute{}, []goform.ValidatorInterface{

		&goform.RequiredValidator{},

	}, []goform.FilterInterface{})

	password := goform.NewPasswordElement("password", "Password", []*goform.Attribute{}, []goform.ValidatorInterface{}, []goform.FilterInterface{})

	submit := goform.NewButtonElement("submit", "Login", []*goform.Attribute{})

	form := goform.NewGoForm()

	form.Add(email)

	form.Add(password)

	form.Add(submit)

	tpl, _ := template.New("tpl").Parse(view)

	http.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) {

		w.Header().Set("Content-Type", "text/html")

		if r.Method != "POST" {

			tpl.Execute(w, form)

			return

		}

		r.ParseForm()

		form.BindFromRequest(r)

		s := YourStruct{}

		form.MapTo(&s)

		fmt.Println(s)

	})

	http.ListenAndServe(":2626", nil)

}

```

### Validate a request

```go

package main

import (

	"github.com/semihs/goform"

	"net/http"

	"text/template"

)

var view string = `

{{range .GetElements}}

  {{.Render}}

{{end}}

`

func main() {

	email := goform.NewEmailElement("email", "Email", []*goform.Attribute{}, []goform.ValidatorInterface{

		&goform.RequiredValidator{},

	}, []goform.FilterInterface{})

	password := goform.NewPasswordElement("password", "Password", []*goform.Attribute{}, []goform.ValidatorInterface{}, []goform.FilterInterface{})

	submit := goform.NewButtonElement("submit", "Login", []*goform.Attribute{})

	form := goform.NewGoForm()

	form.Add(email)

	form.Add(password)

	form.Add(submit)

	tpl, _ := template.New("tpl").Parse(view)

	http.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) {

		w.Header().Set("Content-Type", "text/html")

		if r.Method != "POST" {

			tpl.Execute(w, form)

			return

		}

		r.ParseForm()

		form.BindFromRequest(r)

		if !form.IsValid() {

			tpl.Execute(w, form)

			return

		}

	})

	http.ListenAndServe(":2626", nil)

}

```

### Change Template

goform provides bootstrap 4 alpha textual and inline templates, if you want to make custom template look at the template.go and use SetTemplate method form. Your template must be goform.Theme type

```go

package main

import (

	"github.com/semihs/goform"

	"net/http"

	"text/template"

)

var view string = `

{{range .GetElements}}

  {{.Render}}

{{end}}

`

func main() {

	email := goform.NewEmailElement("email", "Email", []*goform.Attribute{}, []goform.ValidatorInterface{

		&goform.RequiredValidator{},

	}, []goform.FilterInterface{})

	password := goform.NewPasswordElement("password", "Password", []*goform.Attribute{}, []goform.ValidatorInterface{}, []goform.FilterInterface{})

	submit := goform.NewButtonElement("submit", "Login", []*goform.Attribute{})

	form := goform.NewGoForm()

	form.SetTheme(goform.ThemeBootstrap4alpha6Inline)

	form.Add(email)

	form.Add(password)

	form.Add(submit)

	tpl, _ := template.New("tpl").Parse(view)

	http.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) {

		w.Header().Set("Content-Type", "text/html")

		if r.Method != "POST" {

			tpl.Execute(w, form)

			return

		}

	})

	http.ListenAndServe(":2626", nil)

}

```

### Build Query

```go

package main

import (

	"fmt"

	"github.com/semihs/goform"

	"net/http"

	"text/template"

)

var view string = `

{{range .GetElements}}

  {{.Render}}

{{end}}

`

func main() {

	email := goform.NewEmailElement("email", "Email", []*goform.Attribute{}, []goform.ValidatorInterface{

		&goform.RequiredValidator{},

	}, []goform.FilterInterface{})

	password := goform.NewPasswordElement("password", "Password", []*goform.Attribute{}, []goform.ValidatorInterface{}, []goform.FilterInterface{})

	submit := goform.NewButtonElement("submit", "Login", []*goform.Attribute{})

	form := goform.NewGoForm()

	form.Add(email)

	form.Add(password)

	form.Add(submit)

	tpl, _ := template.New("tpl").Parse(view)

	http.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) {

		w.Header().Set("Content-Type", "text/html")

		if r.Method != "POST" {

			tpl.Execute(w, form)

			return

		}

		r.ParseForm()

		form.BindFromRequest(r)

		fmt.Println(form.BuildQuery())

	})

	http.ListenAndServe(":2626", nil)

}

```

### Elements

#### Text Element

```go

goform.NewTextElement("element_name", "Element Label", []*goform.Attribute{}, []goform.ValidatorInterface{}, []goform.FilterInterface{})

```

#### Textarea Element

```go

goform.NewTextareaElement("element_name", "Element Label", []*goform.Attribute{}, []goform.ValidatorInterface{}, []goform.FilterInterface{})

```

#### Email Element

```go

goform.NewEmailElement("element_name", "Element Label", []*goform.Attribute{}, []goform.ValidatorInterface{}, []goform.FilterInterface{})

```

#### Checkbox Element

```go

goform.NewCheckboxElement("element_name", "Element Label", []*goform.Attribute{}, []goform.ValidatorInterface{}, []goform.FilterInterface{})

```

#### Select Element

```go

goform.NewSelectElement("element_name", "Element Label", []*goform.Attribute{}, []*goform.ValueOption{

    &goform.ValueOption{Value: "1", Label: "Option 1"},

    &goform.ValueOption{Value: "2", Label: "Option 2"},

}, []goform.ValidatorInterface{}, []goform.FilterInterface{})

```

#### Radio Element

```go

goform.NewRadioElement("element_name", "Element Label", []*goform.Attribute{}, []*goform.ValueOption{

    &goform.ValueOption{Value: "1", Label: "Option 1"},

    &goform.ValueOption{Value: "2", Label: "Option 2"},

}, []goform.ValidatorInterface{}, []goform.FilterInterface{})

```

#### Multicheckbox Element

```go

goform.NewMultiCheckboxElement("element_name", "Element Label", []*goform.Attribute{}, []*goform.ValueOption{

    &goform.ValueOption{Value: "1", Label: "Option 1"},

    &goform.ValueOption{Value: "2", Label: "Option 2"},

}, []goform.ValidatorInterface{}, []goform.FilterInterface{})

```

#### Number Element

```go

goform.NewNumberElement("element_name", "Element Label", []*goform.Attribute{}, []goform.ValidatorInterface{}, []goform.FilterInterface{})

```

#### Search Element

```go

goform.NewSearchElement("element_name", "Element Label", []*goform.Attribute{}, []goform.ValidatorInterface{}, []goform.FilterInterface{})

```

#### Tel Element

```go

goform.NewTelElement("element_name", "Element Label", []*goform.Attribute{}, []goform.ValidatorInterface{}, []goform.FilterInterface{})

```

#### Hidden Element

```go

goform.NewHiddenElement("element_name", "Element Label", []*goform.Attribute{}, []goform.ValidatorInterface{}, []goform.FilterInterface{})

```

#### Password Element

```go

goform.NewPasswordElement("element_name", "Element Label", []*goform.Attribute{}, []goform.ValidatorInterface{}, []goform.FilterInterface{})

```

#### Image Element

```go

goform.NewImageElement("element_name", "Element Label", []*goform.Attribute{

        &goform.Attribute{Key:"src", Value: "/img/src/image.png"}

}, []goform.ValidatorInterface{}, []goform.FilterInterface{})

```

#### Button Element

```go

goform.NewButtonElement("submit", "Save", []*goform.Attribute{})

```

#### Submit Element

```go

goform.NewSubmitElement("submit", "Save", []*goform.Attribute{})

```

## Todo List

* Input Filters (tolower, toupper, alpha, numeric...)

* Validations (identical, min-max length, min-max value, alpha, regex...)

* Tests