view

package
v0.0.0-...-06d4dd4 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Jan 16, 2013 License: MIT Imports: 31 Imported by: 0

Documentation

Overview

The View of MVC.

Instead of using text templates, go-start creates HTML by using strongly typed Go composite literals. For some HTML constructs there are high level Go representations, but most HTML elements have a direct Go type or shortcut function counterpart.

Shortcut functions for HTML elements are all upper case, other utility functions follow the normal camel case naming convention.

All shortcuts (see shortcuts.go):

ViewOrError(view View, err error) View

Escape(text string) HTML

Printf(text string, args ...interface{}) HTML

PrintfEscape(text string, args ...interface{}) HTML

A(url interface{}, content ...interface{}) Link

A_nofollow(url interface{}, content ...interface{}) Link

A_blank(url interface{}, content ...interface{}) *Link

A_blank_nofollow(url interface{}, content ...interface{}) *Link

STYLE(css string) HTML

StylesheetLink(url string) HTML

SCRIPT(javascript string) HTML

ScriptLink(url string) HTML

RSSLink(title string, url URL) View

IMG(url string, dimensions ...int)

SECTION(class string, content ...interface{}) View

DIV(class string, content ...interface{}) *Div

SPAN(class string, content ...interface{}) *Span

DivClearBoth() HTML

CANVAS(class string, width, height int) *Canvas

BR() HTML

HR() HTML

P(content ...interface{}) View

H1(content ...interface{}) View

H2(content ...interface{}) View

H3(content ...interface{}) View

H4(content ...interface{}) View

H5(content ...interface{}) View

H6(content ...interface{}) View

B(content ...interface{}) View

I(content ...interface{}) View

Q(content ...interface{}) View

DEL(content ...interface{}) View

EM(content ...interface{}) View

STRONG(content ...interface{}) View

DFN(content ...interface{}) View

CODE(content ...interface{}) View

PRE(content ...interface{}) View

ABBR(longTitle, abbreviation string) View

UL(items ...interface{}) *List

OL(items ...interface{}) *List

NewView(content interface{}) View

NewViews(contents ...interface{}) Views

WrapContents(contents ...interface{}) View

Index

Constants

View Source
const (
	RichTextAreaDefaultCols = 80
	RichTextAreaDefaultRows = 10
)
View Source
const (
	TextAreaDefaultCols = 80
	TextAreaDefaultRows = 3
)
View Source
const FormIDName = "gostart_form_id"
View Source
const LoremIpsum = "" /* 3101-byte string literal not displayed */
View Source
const ModalDialogCloseScript = "Avgrund.hide();"
View Source
const MultipartFormData = "multipart/form-data"
View Source
const PathFragmentPattern = "([a-zA-Z0-9_\\-\\.]+)"

Variables

View Source
var Config = Configuration{
	ListenAndServeAt: "0.0.0.0:80",
	TemplateSystem:   &templatesystem.Mustache{},
	Page: PageConfiguration{
		Template:            "html5boilerplate.html",
		DefaultCSS:          "/style.css",
		DefaultMetaViewport: "width=device-width",
	},
	Form: FormConfiguration{
		DefaultLayout: &StandardFormLayout{
			DefaultInputSize:      80,
			DefaultTableInputSize: 20,
		},
		DefaultCSRFProtector:            nil,
		DefaultSubmitButtonText:         "Save",
		DefaultErrorMessageClass:        "error",
		DefaultSuccessMessageClass:      "success",
		DefaultFieldDescriptionClass:    "description",
		DefaultRequiredMarker:           HTML("<span class='required'>*</span>"),
		GeneralErrorMessageOnFieldError: "This form has errors",
		DefaultFieldControllers: FormFieldControllers{
			ModelStringController{},
			ModelTextController{},
			ModelRichTextController{},
			ModelUrlController{},
			ModelEmailController{},
			ModelPasswordController{},
			ModelIntController{},
			ModelFloatController{},
			ModelPhoneController{},
			ModelBoolController{},
			ModelChoiceController{},
			ModelMultipleChoiceController{},
			ModelDynamicChoiceController{},
			ModelDateController{},
			ModelDateTimeController{},
			ModelFileController{},
			ModelBlobController{},
		},
	},
	RichText: RichTextConfiguration{
		DefaultToolbar: SetDefaultToolbar(),
		ToolbarCSS:     "/css/wysihtml5/toolbar-stylesheet.css",
		EditorCSS:      "",
		UseGlobalCSS:   false,
	},
	LabeledModelViewLabelClass: "labeled-model-view-label",
	LabeledModelViewValueClass: "labeled-model-view-value",
	BaseDirs:                   []string{"."},
	StaticDirs:                 []string{"static"},
	TemplateDirs:               []string{"templates"},
	SessionTracker:             &CookieSessionTracker{},
	SessionDataStore:           NewCookieSessionDataStore(),
	NamedAuthenticators:        make(map[string]Authenticator),
}
View Source
var StructTagKey = "view"

Functions

func ClearAllCaches

func ClearAllCaches()

ClearAllCaches cals ClearCache() for all CachedView objects created with CacheView().

func DecryptCookie

func DecryptCookie(data []byte) (result []byte, err error)

func EncryptCookie

func EncryptCookie(data []byte) (result []byte, err error)

func FindStaticFile

func FindStaticFile(filename string) (filePath string, found bool, modifiedTime time.Time)

func FindTemplateFile

func FindTemplateFile(filename string) (filePath string, found bool, modifiedTime time.Time)

func GetFileUploadFormModel

func GetFileUploadFormModel(form *Form, ctx *Context) (interface{}, error)

GetFileUploadFormModel when set at Form.GetModel will create a file upload form. Form.Enctype will be set to "multipart/form-fata" *FileUploadFormModel will be passed as formModel at Form.OnSubmit

func NewViewID

func NewViewID(view View) (id string)

func RenderChildViewsHTML

func RenderChildViewsHTML(parent View, ctx *Context) (err error)

func RenderTemplate

func RenderTemplate(filename string, out io.Writer, context interface{}) (err error)

func RenderTemplateString

func RenderTemplateString(tmplString string, name string, out io.Writer, context interface{}) (err error)

func RunServer

func RunServer(paths *ViewPath)

RunServer starts a webserver with the given paths. If paths is nil, only static files will be served.

func RunServerAddr

func RunServerAddr(addr string, paths *ViewPath)

RunServerAddr starts a webserver with the given paths and address. If paths is nil, only static files will be served.

func SetDefaultToolbar

func SetDefaultToolbar() string

func TableHeaderRow

func TableHeaderRow(views ...View) func(ctx *Context) (Views, error)

func TableHeaderRowEscape

func TableHeaderRowEscape(s ...string) func(ctx *Context) (Views, error)

Types

type AllAuthenticators

type AllAuthenticators []Authenticator

AllAuthenticators returns true if all of its authenticators return true.

func (AllAuthenticators) Authenticate

func (self AllAuthenticators) Authenticate(ctx *Context) (ok bool, err error)

type AnyAuthenticator

type AnyAuthenticator []Authenticator

AnyAuthenticator returns true if any of its authenticators returns true.

func (AnyAuthenticator) Authenticate

func (self AnyAuthenticator) Authenticate(ctx *Context) (ok bool, err error)

type Aside

type Aside struct {
	ViewBaseWithId
	Class   string
	Style   string
	Content View
}

Aside represents a HTML aside element.

func (*Aside) IterateChildren

func (self *Aside) IterateChildren(callback IterateChildrenCallback)

func (*Aside) Render

func (self *Aside) Render(ctx *Context) (err error)

type Authenticator

type Authenticator interface {
	// Authenticate returns the auth result in ok,
	// err is used for real errors not negative authentication
	Authenticate(ctx *Context) (ok bool, err error)
}

Authenticator authenticates the user of a request context.

func NamedAuthenticator

func NamedAuthenticator(name string) (auth Authenticator, ok bool)

type BasicAuth

type BasicAuth struct {
	Realm        string
	UserPassword map[string]string
}

BasicAuth implements HTTP basic auth as Authenticator.

func NewBasicAuth

func NewBasicAuth(realm string, username string, password string) *BasicAuth

NewBasicAuth creates a BasicAuth instance with a single username and password.

func (*BasicAuth) Authenticate

func (self *BasicAuth) Authenticate(ctx *Context) (ok bool, err error)

type BoolAuth

type BoolAuth bool

BoolAuth always returns its value at Authenticate(). Can be used for debugging.

func (BoolAuth) Authenticate

func (self BoolAuth) Authenticate(ctx *Context) (ok bool, err error)

type Button

type Button struct {
	ViewBaseWithId
	Name           string
	Class          string
	Disabled       bool
	TabIndex       int
	OnClick        string
	OnClickConfirm string // Will add a confirmation dialog for onclick
	Content        View   // Only used when Submit is false
}

func ModalDialogCloseButton

func ModalDialogCloseButton(text string) *Button

func (*Button) IterateChildren

func (self *Button) IterateChildren(callback IterateChildrenCallback)

func (*Button) Render

func (self *Button) Render(ctx *Context) (err error)

type CSRFProtector

type CSRFProtector interface {
	ExtraFormField() View
	Validate(ctx *Context) (ok bool, err error)
}

type CachedView

type CachedView struct {
	ViewBaseWithId
	Content  View
	Duration time.Duration
	// contains filtered or unexported fields
}

CachedView implements ViewWithURL. If Content implements ViewWithURL too, the ViewWithURL methods will be forwarded to Content. Else CachedView provides its own implementation of ViewWithURL. Caching will be disabled, when the request is not a GET or has url parameters.

func CacheView

func CacheView(duration time.Duration, view View) *CachedView

CacheView caches view for duration by wrapping it with a CachedView object. The CachedView is added to an internal list so that ClearAllCaches() can call ClearCache() on every CachedView. UncacheView() removes the CachedView from the internal list.

func (*CachedView) ClearCache

func (self *CachedView) ClearCache()

func (*CachedView) IterateChildren

func (self *CachedView) IterateChildren(callback IterateChildrenCallback)

func (*CachedView) Render

func (self *CachedView) Render(ctx *Context) (err error)

func (*CachedView) SetPath

func (self *CachedView) SetPath(path string)

func (*CachedView) URL

func (self *CachedView) URL(ctx *Context) string

type Canvas

type Canvas struct {
	ViewBaseWithId
	Class  string
	Width  int
	Height int
}

func CANVAS

func CANVAS(class string, width, height int) *Canvas

CANVAS creates <canvas class="class" width="width" height="height"></canvas>

func (*Canvas) Render

func (self *Canvas) Render(ctx *Context) (err error)

type Checkbox

type Checkbox struct {
	ViewBaseWithId
	Name     string
	Label    string
	Checked  bool
	Disabled bool
	Class    string
}

Checkbox represents a HTML input element of type checkbox.

func (*Checkbox) Render

func (self *Checkbox) Render(ctx *Context) (err error)

type Comment

type Comment string

func (Comment) ID

func (self Comment) ID() string

func (Comment) Init

func (self Comment) Init(thisView View)

func (Comment) IterateChildren

func (self Comment) IterateChildren(callback IterateChildrenCallback)

func (Comment) Render

func (self Comment) Render(ctx *Context) (err error)

type ConcatStaticFiles

type ConcatStaticFiles struct {
	ViewWithURLBase
	Filenames []string
	// Will be set automatically from Filenames[0] if empty
	ContentTypeExt string
	// contains filtered or unexported fields
}

ConcatStaticFiles renders multiple static files concatenated as single file. The output is cached in memory but changes to the files on the filesystem cause the the cache to be rebuilt.

func NewConcatStaticFiles

func NewConcatStaticFiles(filenames ...string) *ConcatStaticFiles

func (*ConcatStaticFiles) Render

func (self *ConcatStaticFiles) Render(ctx *Context) (err error)

type Configuration

type Configuration struct {
	ListenAndServeAt           string
	IsProductionServer         bool // IsProductionServer will be set to true if localhost resolves to one of ProductionServerIPs
	ProductionServerIPs        []string
	TemplateSystem             templatesystem.Implementation
	Page                       PageConfiguration
	Form                       FormConfiguration
	RichText                   RichTextConfiguration
	LabeledModelViewLabelClass string
	LabeledModelViewValueClass string
	DisableCachedViews         bool
	BaseDirs                   []string
	StaticDirs                 []string
	TemplateDirs               []string
	RedirectSubdomains         []string // Exapmle: "www"
	SiteName                   string
	CookieSecret               string
	SessionTracker             SessionTracker
	SessionDataStore           SessionDataStore
	OnPreAuth                  func(ctx *Context) error
	GlobalAuth                 Authenticator // Will allways be used before all other authenticators
	FallbackAuth               Authenticator // Will be used when no other authenticator is defined for the view
	NamedAuthenticators        map[string]Authenticator
	LoginSignupPage            **Page
	// Middlewares               []Middleware
	Debug struct {
		ListenAndServeAt string
		Mode             bool // Will be set to true if IsProductionServer is false
		LogPaths         bool
		LogRedirects     bool
	}
	// contains filtered or unexported fields
}

func (*Configuration) Close

func (self *Configuration) Close() error

func (*Configuration) Init

func (self *Configuration) Init() error

func (*Configuration) Name

func (self *Configuration) Name() string

type ContactFormModel

type ContactFormModel struct {
	Name    model.String `view:"label=Your name" model:"maxlen=40"`
	Email   model.Email  `view:"label=Your email address" model:"required|maxlen=40"`
	Subject model.String `view:"label=Subject" model:"maxlen=40"`
	Message model.Text   `view:"label=Your message|cols=40|rows=10" model:"required"`
}

ContactFormModel is a default form model for contact forms.

type Context

type Context struct {
	Request  *Request
	Response *Response
	Session  *Session

	// View that responds to the HTTP request
	RespondingView View

	// Arguments parsed from the URL path
	URLArgs []string

	// Custom response wide data that can be set by the application
	Data      interface{}
	DebugData interface{}
}

func (*Context) ForURLArgs

func (self *Context) ForURLArgs(urlArgs ...string) *Context

ForURLArgs returns an altered Context copy where Context.URLArgs is set to urlArgs. Can be used for calling the the URL() method of a URL interface to get the URL of another view, defined by urlArgs.

The following example gets the URL of MyPage with the first URL argument is that of the current page and the second URL argument is "second-arg":

MyPage.URL(ctx.ForURLArgs(ctx.URLArgs[0], "second-arg"))

func (*Context) ForURLArgsConvert

func (self *Context) ForURLArgsConvert(urlArgs ...interface{}) *Context

type CookieSessionDataStore

type CookieSessionDataStore struct {
	// contains filtered or unexported fields
}

func (*CookieSessionDataStore) Delete

func (self *CookieSessionDataStore) Delete(ctx *Context) (err error)

func (*CookieSessionDataStore) Get

func (self *CookieSessionDataStore) Get(ctx *Context, data interface{}) (ok bool, err error)

func (*CookieSessionDataStore) Set

func (self *CookieSessionDataStore) Set(ctx *Context, data interface{}) (err error)

type CookieSessionTracker

type CookieSessionTracker struct {
}

http://en.wikipedia.org/wiki/HTTP_cookie

func (*CookieSessionTracker) DeleteID

func (self *CookieSessionTracker) DeleteID(ctx *Context)

func (*CookieSessionTracker) ID

func (self *CookieSessionTracker) ID(ctx *Context) string

func (*CookieSessionTracker) SetID

func (self *CookieSessionTracker) SetID(ctx *Context, id string)

type Div

type Div struct {
	ViewBaseWithId
	Class   string
	Style   string
	Content View
	OnClick string
}

Div represents a HTML div element.

func DIV

func DIV(class string, content ...interface{}) *Div

DIV creates <div class="class">content</div>

func (*Div) IterateChildren

func (self *Div) IterateChildren(callback IterateChildrenCallback)

func (*Div) Render

func (self *Div) Render(ctx *Context) (err error)

type DummyImage

type DummyImage struct {
	ViewBaseWithId
	Class           string
	Width           int
	Height          int
	BackgroundColor string
	ForegroundColor string
	Text            string
}

DummyImage represents a HTML img element with src utilizing http://dummyimage.com.

func NewDummyImage

func NewDummyImage(width, height int) *DummyImage

func (*DummyImage) Render

func (self *DummyImage) Render(ctx *Context) (err error)

type DynamicView

type DynamicView func(ctx *Context) (view View, err error)

DynamicView implements View for a function that creates and renders a dynamic child-view in the Render method.

Example:

dynamicView := DynamicView(
	func(ctx *Context) (view View, err error) {
		return HTML("return dynamic created views here"), nil
	},
)

func DynamicViewBindURLArgs

func DynamicViewBindURLArgs(getViewFunc interface{}) DynamicView

DynamicViewBindURLArgs creates a View where getViewFunc is called from View.Render with Context.URLArgs converted to function arguments. The first getViewFunc argument can be of type *Context, but this is optional. All further arguments will be converted from the corresponding Context.URLArgs string to their actual type. Conversion to integer, float, string and bool arguments are supported. If there are more URLArgs than function args, then supernumerous URLArgs will be ignored. If there are less URLArgs than function args, then the function args will receive their types zero value. The first result value of getViewFunc has to be of type View, the second result is optional and of type error.

Example:

view.DynamicViewBindURLArgs(func(i int, b bool) view.View {
	return view.Printf("ctx.URLArgs[0]: %d, ctx.URLArgs[1]: %b", i, b)
})

func (DynamicView) ID

func (self DynamicView) ID() string

func (DynamicView) Init

func (self DynamicView) Init(thisView View)

func (DynamicView) IterateChildren

func (self DynamicView) IterateChildren(callback IterateChildrenCallback)

func (DynamicView) Render

func (self DynamicView) Render(ctx *Context) error

type Error

type Error struct {
	Err error
}

Error wraps an error and returns it at the Render() method.

func NewError

func NewError(err error) *Error

func (*Error) Error

func (self *Error) Error() string

func (*Error) ID

func (self *Error) ID() string

func (*Error) Init

func (self *Error) Init(thisView View)

func (*Error) IterateChildren

func (self *Error) IterateChildren(callback IterateChildrenCallback)

func (*Error) Render

func (self *Error) Render(ctx *Context) (err error)

type EscapeStringsListModel

type EscapeStringsListModel []string

func (EscapeStringsListModel) ItemView

func (self EscapeStringsListModel) ItemView(index int, ctx *Context) (view View, err error)

func (EscapeStringsListModel) NumItems

func (self EscapeStringsListModel) NumItems() int

type EscapeStringsTableModel

type EscapeStringsTableModel [][]string

func (EscapeStringsTableModel) CellView

func (self EscapeStringsTableModel) CellView(row int, column int, ctx *Context) (view View, err error)

func (EscapeStringsTableModel) Columns

func (self EscapeStringsTableModel) Columns() int

func (EscapeStringsTableModel) Rows

func (self EscapeStringsTableModel) Rows() int

type FileInput

type FileInput struct {
	ViewBaseWithId
	Class    string
	Name     string
	Disabled bool
}

func (*FileInput) Render

func (self *FileInput) Render(ctx *Context) (err error)

type FileUploadFormModel

type FileUploadFormModel struct {
	File model.File
}

type Forbidden

type Forbidden string

func (Forbidden) Error

func (self Forbidden) Error() string

type Form

type Form struct {
	ViewBaseWithId
	Class  string
	Style  string
	Action string // Default is "." plus any URL params
	Method string // Default is POST
	// If there are multiple forms on one page, then every form
	// needs a unique FormID, because the POST request with the form
	// data is made to the same URL or the page.
	// FormID can be empty if there is only one form on a page,
	// but it's good practice to always assign a FormID, because then
	// forms later added to the page won't lead to conflicts.
	FormID           string
	CSRFProtector    CSRFProtector
	Layout           FormLayout           // Config.Form.DefaultLayout will be used if nil
	FieldControllers FormFieldControllers // Config.Form.DefaultFieldControllers will be used in nil

	// GetModel returns the data-model used to create the form fields
	// and will receive changes from a form submit.
	// Thus, the model must be setable by reflection.
	// Be careful to not return the same model object at every call,
	// because the changed model from a submit will then be re-used
	// at a later form display which is usually not wanted.
	// Use the wrapper function FormModel() only when the form is
	// embedded in a DynamicView and the model argument is dynamically
	// created per View render.
	GetModel GetFormModelFunc

	// ModelFieldAuth maps a field selector to an Authenticator.
	// Fields that match the selector will only be displayed if the
	// Authenticator returns true.
	ModelFieldAuth map[string]Authenticator

	/*
		OnSubmit is called after the form was submitted by the user
		and did not contain any validation errors.
		If the OnSubmit result err is nil and the redirect result
		is not nil, then a HTTP 302 redirect will be issued.
		Else if the OnSubmit result message is not empty, it will be displayed
		in the form regardless of the result err.
		If the results message and err are nil, then Form.SuccessMessage
		will be	displayed in the form.
		If the result err is not nil and message is empty, then err will be
		displayed in the form. Else message will be displayed.
		This can be used to return a readable error message for the user
		via message and an internal error for logging via err.
	*/
	OnSubmit OnFormSubmitFunc

	// OnValidationError is called when the form model failed to validate.
	OnValidationError OnFormValidationErrorFunc

	// NewFieldInput is a hook that will be called instead of FieldFactory.NewInput
	// if not nil. Can be used for form specific alterations to the form layout.
	NewFieldInput func(withLabel bool, metaData *model.MetaData, form *Form) (View, error)

	ModelMaxDepth            int      // if zero, no depth limit
	ExcludedFields           []string // Use point notation for nested fields. In case of arrays/slices use wildcards
	HiddenFields             []string // Use point notation for nested fields. In case of arrays/slices use wildcards
	DisabledFields           []string // Use point notation for nested fields
	RequiredFields           []string // Also available as static struct field tag. Use point notation for nested fields
	Labels                   map[string]string
	FieldDescriptions        map[string]string
	InputSizes               map[string]int
	ErrorMessageClass        string // If empty, Config.Form.DefaultErrorMessageClass will be used
	SuccessMessageClass      string // If empty, Config.Form.DefaultSuccessMessageClass will be used
	FieldDescriptionClass    string
	GeneralErrorOnFieldError bool
	RequiredMarker           View // If nil, Config.Form.DefaultRequiredMarker will be used
	SuccessMessage           string
	SubmitButtonText         string
	SubmitButtonClass        string
	SubmitButtonConfirm      string // Will add a confirmation dialog for onclick
	ShowRefIDs               bool
	Enctype                  string
}

Form creates an input form for a data model.

Gists:

https://gist.github.com/3748164

Note:

CSRF protection is not implemented yet

The data model:

The default behavior of Form is to send a POST request with the form data to the same URL of the page it is located in. Form then takes the values from the POST request and sets them at the data model and then validates the model.

If there are multiple forms on one page, then every form needs a unique FormID, because the POST request with the form data is made to the same URL or the page. FormID can be empty if there is only one form on a page, but it's good practice to always assign a FormID, because then forms later added to the page won't lead to conflicts.

The model for the form is provided the GetModel function. It can be a struct of model.Value implementations like model.String or model.Bool or a slice of model.DynamicValue (which is available as type model.DynamicValues with additional methods). If the model was declared as variable before the form, then the helper function FormModel() can be used for GetModel. Note that model structs are always passed on as pointers.

Example:

var structModel struct {
	A, B model.Bool
}
&Form{
	GetModel: FormModel(&structModel),
}

&Form{
	GetModel: func(form *Form, ctx *Context) (interface{}, error) {
		dynamicModel := model.DynamicValues{
			{Name: "A": Value: model.NewBool(true)},
			{Name: "B": Value: model.NewString("go-start is awesome")},
			{Name: "C": Value: model.NewString("Required")},
		}
		dynamicModel[2].SetAttrib("model", "required", "true")
		return dynamicModel, nil
	}
}

The names of the exported struct fields or model.DynamicValue.Name is used as label for the generated form fields. The labels of struct fields can be overridden by adding a view tag like `view:"label=Hello World!".

Example:

type MyModel struct {
	AnInt model.Int                           // Label will be "AnInt"
	Overr model.String `view:"label=A String" // Label will be "A String"
}

Labels can also be overridden on a per form basis by setting Form.Labels which is a map[string]string. The "selector" of a field is used as key and the label as value in the map.

Form field selectors:

A selector is the path of struct field names or model.DynamicValue.Name from the root of the model to the described concatenated by ".". In case of slice or array fields, the index is used as field name. The wildcard character $ can be used to select all fields of a slice or array.

Example:

type MyModel struct {
	A model.String
	B struct {
		X model.Int
	}
	C [2]struct{
		Y model.Int
	}
}

"A"     selects MyModel.A
"B.X"   selects MyModel.B.X
"C.1.Y" selects MyModel.C[1].Y
"C.$.Y" selects MyModel.C[0].Y and MyModel.C[1].Y

Selectors can also be used to mark data model fields as required, excluded, hidden, disabled by setting them at Form.RequiredFields, Form.ExcludedFields, Form.HiddenFields and Form.DisabledFields. Required fields must not be empty to validate. Hidden fields generate hidden HTML form input elements, whereas excluded fields are completely ignored.

required can also be set as model tag, hidden and disabled as view tags at struct fields of the data model.

Example:

var myModel struct {
	Required1 model.String `model:"required"`
	Required2 model.Int
	Hidden1   model.Float `view:"hidden"`
	Hidden2   model.Url
	Disabled1 model.Bool `view:"disabled"`
	Disabled2 model.Email
	Excluded  model.String
}
&Form{
	RequiredFields: []string{"Required2"},
	HiddenFields:   []string{"Hidden2"},
	DisabledFields: []string{"Disabled2"},
	ExcludedFields: []string{"Excluded"},
	GetModel:       FormModel(&myModel),
}

Data validation:

All model.Value implementations also implement model.Validator. Custom model wide validation can be achieved by implementing model.Validator for the whole model or parts of it.

Example from user/formmodels.go:

type PasswordFormModel struct {
	Password1 model.Password `model:"minlen=6" view:"label=Password|size=20"`
	Password2 model.Password `view:"label=Repeat password|size=20"`
}

func (self *PasswordFormModel) Validate(metaData *model.MetaData) error {
	if self.Password1 != self.Password2 {
		return errors.New("Passwords don't match")
	}
	return nil
}

If there were any validations errors Form.OnValidationError will be called if not nil, or else Form.OnSubmit.

Processing the submitted data:

Form.OnSubmit returns three values: (message string, redirect URL, err error) If error is nil and redirect is not nil, then a redirect response will be sent. Without redirect message will be displayed if not empty. The message will be styled as success message if err is nil, else as error message. If message is empty and err is not nil, then err will be displayed as error message. Keep in mind, that users of a website are not interested in technical details of internal errors, they can even be used to hack the website. So use message to return a sanitized message for the user and error for internal logging.

Form layout:

todo

Slices and arrays in the data model will be displayed as table by StandardFormLayout

Styling:

todo

func NewContactForm

func NewContactForm(recipientEmail, subjectPrefix, formClass, buttonClass, formID string) *Form

NewContactForm creates a new contact form that sends submitted data to recipientEmail.

func (*Form) AddMongoRefController

func (self *Form) AddMongoRefController(refSelector string, labelSelectors ...string)

AddCustomMongoRefController adds a FormFieldController that creates a drop-down lists or auto-completion fields for mongo.Ref fields in the form model. refSelector selects for which mongo.Ref fields this FormFieldController should be used. An empty string selects all mongo.Ref in the form model. labelSelector is a selector into the referenced documents to retrieve the labels for the documents. If labelSelector is an empty string, then a struct tag `view:"optionsLabel="` will be used or DocumentLabelSelector from the mongo.Ref's collection. options iterates the possible documents for the mongo.Ref. If options is nil, then all documents of the mongo.Ref's collection are used.

func (*Form) AddRestrictedMongoRefController

func (self *Form) AddRestrictedMongoRefController(options model.Iterator, refSelector string, labelSelectors ...string)

func (*Form) DirectFieldLabel

func (self *Form) DirectFieldLabel(metaData *model.MetaData) string

DirectFieldLabel returns a label for a form field generated from metaData. It creates the label only from the name or label tag of metaData, not including its parents.

func (*Form) FieldInputClass

func (self *Form) FieldInputClass(metaData *model.MetaData) string

func (*Form) FieldLabel

func (self *Form) FieldLabel(metaData *model.MetaData) string

FieldLabel returns a label for a form field generated from metaData. It creates the label from the names or label tags of metaData and all its parents, starting with the root parent, concanated with a space character.

func (*Form) GetCSRFProtector

func (self *Form) GetCSRFProtector() CSRFProtector

GetCSRFProtector returns self.CSRFProtector if not nil, else Config.Form.DefaultCSRFProtector will be returned.

func (*Form) GetErrorMessageClass

func (self *Form) GetErrorMessageClass() string

func (*Form) GetFieldControllers

func (self *Form) GetFieldControllers() FormFieldControllers

GetFieldControllers returns self.FieldControllers if not nil, else Config.Form.DefaultFieldControllers will be returned.

func (*Form) GetFieldDescription

func (self *Form) GetFieldDescription(metaData *model.MetaData) string

func (*Form) GetFieldDescriptionClass

func (self *Form) GetFieldDescriptionClass() string

func (*Form) GetInputSize

func (self *Form) GetInputSize(metaData *model.MetaData) int

func (*Form) GetLayout

func (self *Form) GetLayout() FormLayout

GetLayout returns self.Layout if not nil, else Config.Form.DefaultLayout will be returned.

func (*Form) GetRequiredMarker

func (self *Form) GetRequiredMarker() View

func (*Form) GetSubmitButtonClass

func (self *Form) GetSubmitButtonClass() string

func (*Form) GetSubmitButtonText

func (self *Form) GetSubmitButtonText() string

Returns self.SubmitButtonText if not empty, else Config.Form.DefaultSubmitButtonText

func (*Form) GetSuccessMessageClass

func (self *Form) GetSuccessMessageClass() string

func (*Form) InputFieldPlaceholder

func (self *Form) InputFieldPlaceholder(metaData *model.MetaData) string

func (*Form) IsFieldDisabled

func (self *Form) IsFieldDisabled(field *model.MetaData) bool

func (*Form) IsFieldExcluded

func (self *Form) IsFieldExcluded(field *model.MetaData, ctx *Context) bool

IsFieldExcluded returns weather a field will be excluded from the form. Fields will be excluded, if their selector matches one in Form.ExcludedFields or if a matching Authenticator from Form.ModelFieldAuth returns false. A field is also excluded when its parent field is excluded. This function is not restricted to model.Value, it works with all struct fields. This way a whole sub struct an be excluded by adding its selector to Form.ExcludedFields.

func (*Form) IsFieldHidden

func (self *Form) IsFieldHidden(field *model.MetaData) bool

IsFieldHidden returns if a hidden input element will be created for a form field. Hidden fields are not validated.

func (*Form) IsFieldRequired

func (self *Form) IsFieldRequired(field *model.MetaData) bool

func (*Form) IsFieldVisible

func (self *Form) IsFieldVisible(field *model.MetaData, ctx *Context) bool

IsFieldVisible returns if the FormFieldFactory can create an input widget for the field, and if the field neither hidden or excluded. Only visible fields are validated. IsFieldExcluded and IsFieldHidden have different semantics.

func (*Form) IsPost

func (self *Form) IsPost(request *Request) bool

func (*Form) Render

func (self *Form) Render(ctx *Context) (err error)

type FormConfiguration

type FormConfiguration struct {
	DefaultLayout                   FormLayout
	DefaultCSRFProtector            CSRFProtector
	DefaultErrorMessageClass        string
	DefaultSuccessMessageClass      string
	DefaultSubmitButtonClass        string
	DefaultFieldDescriptionClass    string
	StandardFormLayoutDivClass      string
	DefaultSubmitButtonText         string
	GeneralErrorMessageOnFieldError string
	DefaultRequiredMarker           View
	DefaultFieldControllers         FormFieldControllers
}

type FormFieldController

type FormFieldController interface {
	// Supports returns if this controller supports a model with the given metaData.
	Supports(metaData *model.MetaData, form *Form) bool

	// NewInput creates a new form field input view for the model metaData.
	NewInput(withLabel bool, metaData *model.MetaData, form *Form) (input View, err error)

	// SetValue sets the value of the model from HTTP POST form data.
	SetValue(value string, ctx *Context, metaData *model.MetaData, form *Form) error
}

FormFieldController is a MVC controller for form fields.

type FormFieldControllers

type FormFieldControllers []FormFieldController

func (FormFieldControllers) NewInput

func (self FormFieldControllers) NewInput(withLabel bool, metaData *model.MetaData, form *Form) (input View, err error)

func (FormFieldControllers) SetValue

func (self FormFieldControllers) SetValue(value string, ctx *Context, metaData *model.MetaData, form *Form) error

func (FormFieldControllers) Supports

func (self FormFieldControllers) Supports(metaData *model.MetaData, form *Form) bool

type FormLayout

type FormLayout interface {
	GetDefaultInputSize(metaData *model.MetaData) int

	BeginFormContent(form *Form, ctx *Context, formContent *Views) error
	// SubmitSuccess will be called before EndFormContent if there were no
	// validation errors of the posted form data and Form.OnSubmit has
	// not returned an error.
	SubmitSuccess(message string, form *Form, ctx *Context, formContent *Views) error
	// SubmitError will be called before EndFormContent if there were no
	// validation errors of the posted form data and Form.OnSubmit has
	// returned an error.
	SubmitError(message string, form *Form, ctx *Context, formContent *Views) error
	EndFormContent(fieldValidationErrs, generalValidationErrs []error, form *Form, ctx *Context, formContent *Views) error

	BeginNamedFields(namedFields *model.MetaData, form *Form, ctx *Context, formContent *Views) error
	NamedField(field *model.MetaData, validationErr error, form *Form, ctx *Context, formContent *Views) error
	EndNamedFields(namedFields *model.MetaData, validationErr error, form *Form, ctx *Context, formContent *Views) error

	BeginIndexedFields(indexedFields *model.MetaData, form *Form, ctx *Context, formContent *Views) error
	IndexedField(field *model.MetaData, validationErr error, form *Form, ctx *Context, formContent *Views) error
	EndIndexedFields(indexedFields *model.MetaData, validationErr error, form *Form, ctx *Context, formContent *Views) error

	NewHiddenInput(metaData *model.MetaData, form *Form) (View, error)
	NewTableHeader(metaData *model.MetaData, form *Form) (View, error)
	NewFieldDescrtiption(description string, form *Form) View
	NewFieldErrorMessage(message string, metaData *model.MetaData, form *Form) View
	NewGeneralErrorMessage(message string, form *Form) View
	NewSuccessMessage(message string, form *Form) View
	NewSubmitButton(text, confirmationMessage string, form *Form) *SubmitButton
	NewAddButton(onclick string, form *Form) View
	NewRemoveButton(onclick string, form *Form) View
	NewUpButton(disabled bool, onclick string, form *Form) View
	NewDownButton(disabled bool, onclick string, form *Form) View
}

FormLayout is responsible for creating and structuring all dynamic content of the form including the submit button. It uses Form.GetFieldFactory() to create the field views.

type Format

type Format struct {
	ViewBase
	Text   string
	Args   []interface{}
	Escape bool
}

func (*Format) Render

func (self *Format) Render(ctx *Context) (err error)

type FrontController

type FrontController func(content View) ViewWithURL

func (FrontController) ContentFunc

func (self FrontController) ContentFunc(contentFunc interface{}) ViewWithURL

type GetFormModelFunc

type GetFormModelFunc func(form *Form, ctx *Context) (model interface{}, err error)

func FormModel

func FormModel(model interface{}) GetFormModelFunc

type GetModelIteratorFunc

type GetModelIteratorFunc func(ctx *Context) model.Iterator

func ModelIterator

func ModelIterator(iter model.Iterator) GetModelIteratorFunc

type GetModelIteratorViewFunc

type GetModelIteratorViewFunc func(ctx *Context, model interface{}) (view View, err error)

type GetTemplateContextFunc

type GetTemplateContextFunc func(ctx *Context) (context interface{}, err error)

func TemplateContext

func TemplateContext(context interface{}) GetTemplateContextFunc

type HTML

type HTML string
var JQuery HTML = `` /* 187-byte string literal not displayed */
var JQueryUI HTML = `` /* 207-byte string literal not displayed */

func A_name

func A_name(name string) HTML

A_name creates a named anchor

func BR

func BR() HTML

BR creates <br/>

func DivClearBoth

func DivClearBoth() HTML

DivClearBoth creates <div style='clear:both'></div>

func DummyText

func DummyText(length int) HTML

DummyText return a HTML object with lorem ipsum text the passed length.

func Escape

func Escape(text string) HTML

Escape HTML escapes a string.

func GoogleAnalytics

func GoogleAnalytics(trackingID string) HTML

func GoogleMaps

func GoogleMaps(apiKey string, sensor bool, callback string) HTML

todo: replace http with https if necessary

func HR

func HR() HTML

HR creates <hr/>

func Printf

func Printf(text string, args ...interface{}) HTML

Printf creates an unescaped HTML string.

func PrintfEscape

func PrintfEscape(text string, args ...interface{}) HTML

PrintfEscape creates an escaped HTML string.

func SCRIPT

func SCRIPT(javascript string) HTML

SCRIPT creates <script>javascript</script>

func STYLE

func STYLE(css string) HTML

STYLE creates <style>css</style>

func ScriptLink(url string) HTML

ScriptLink creates <script src='url'></script>

func (HTML) ID

func (self HTML) ID() string

func (HTML) Init

func (self HTML) Init(thisView View)

func (HTML) IterateChildren

func (self HTML) IterateChildren(callback IterateChildrenCallback)

func (HTML) Render

func (self HTML) Render(ctx *Context) (err error)

type HTMLStringsListModel

type HTMLStringsListModel []string

func (HTMLStringsListModel) ItemView

func (self HTMLStringsListModel) ItemView(index int, ctx *Context) (view View, err error)

func (HTMLStringsListModel) NumItems

func (self HTMLStringsListModel) NumItems() int

type HTMLStringsTableModel

type HTMLStringsTableModel [][]string

func (HTMLStringsTableModel) CellView

func (self HTMLStringsTableModel) CellView(row int, column int, ctx *Context) (view View, err error)

func (HTMLStringsTableModel) Columns

func (self HTMLStringsTableModel) Columns() int

func (HTMLStringsTableModel) Rows

func (self HTMLStringsTableModel) Rows() int

type HiddenInput

type HiddenInput struct {
	ViewBaseWithId
	Name  string
	Value string
}

func (*HiddenInput) Render

func (self *HiddenInput) Render(ctx *Context) (err error)

type If

type If struct {
	ViewBaseWithId
	Condition   bool
	Content     View
	ElseContent View
}

func (*If) Init

func (self *If) Init(thisView View)

func (*If) IterateChildren

func (self *If) IterateChildren(callback IterateChildrenCallback)

func (*If) Render

func (self *If) Render(ctx *Context) (err error)

type Iframe

type Iframe struct {
	ViewBaseWithId
	Class        string
	Width        int
	Height       int
	Border       int
	Scrolling    bool
	MarginWidth  int
	MarginHeight int
	Seamless     bool
	URL          string
}

func GoogleMapsIframe

func GoogleMapsIframe(width, height int, location string) *Iframe

func (*Iframe) Render

func (self *Iframe) Render(ctx *Context) (err error)

type Image

type Image struct {
	ViewBaseWithId
	Class  string
	URL    URL    // If URL is set, then Src will be ignored
	Src    string // String URL of the image, used when URL is nil
	Width  int
	Height int
	Title  string
}

func IMG

func IMG(url string, dimensions ...int) *Image

IMG creates a HTML img element for an URL with optional width and height. The first int of dimensions is width, the second one height.

func (*Image) Render

func (self *Image) Render(ctx *Context) (err error)

type IndexedStringsSelectModel

type IndexedStringsSelectModel struct {
	Options []string
	Index   int
}

func (*IndexedStringsSelectModel) Disabled

func (self *IndexedStringsSelectModel) Disabled(index int) bool

func (*IndexedStringsSelectModel) NumOptions

func (self *IndexedStringsSelectModel) NumOptions() int

func (*IndexedStringsSelectModel) RenderLabel

func (self *IndexedStringsSelectModel) RenderLabel(index int, ctx *Context) (err error)

func (*IndexedStringsSelectModel) Selected

func (self *IndexedStringsSelectModel) Selected(index int) bool

func (*IndexedStringsSelectModel) Value

func (self *IndexedStringsSelectModel) Value(index int) string

type IterateChildrenCallback

type IterateChildrenCallback func(parent View, child View) (next bool)

type JQueryDialog

type JQueryDialog struct {
	Div
	Title     string
	AutoOpen  bool
	CloseText string
}

Dependencies of jQuery UI Dialog are not included.

func (*JQueryDialog) CloseScript

func (self *JQueryDialog) CloseScript() string

func (*JQueryDialog) OpenScript

func (self *JQueryDialog) OpenScript() string

func (*JQueryDialog) Render

func (self *JQueryDialog) Render(ctx *Context) (err error)

type Label

type Label struct {
	ViewBaseWithId
	Class   string
	For     View
	Content View
}

func (*Label) Render

func (self *Label) Render(ctx *Context) (err error)

type LabeledModelView

type LabeledModelView struct {
	ViewBase
	Model          interface{}
	Labels         map[string]string
	ExcludedFields []string
	HideEmpty      bool
}

LabeledModelView displays a Model similar to Form, but with immutable strings instead of input fields.

func NewLabeledModelView

func NewLabeledModelView(model interface{}) *LabeledModelView

func (*LabeledModelView) DirectFieldLabel

func (self *LabeledModelView) DirectFieldLabel(metaData *model.MetaData) string

DirectFieldLabel returns a label for a model field generated from metaData. It creates the label only from the name or label tag of metaData, not including its parents.

func (*LabeledModelView) FieldLabel

func (self *LabeledModelView) FieldLabel(metaData *model.MetaData) string

FieldLabel returns a label for a model field generated from metaData. It creates the label from the names or label tags of metaData and all its parents, starting with the root parent, concanated with a space character.

func (*LabeledModelView) IsFieldExcluded

func (self *LabeledModelView) IsFieldExcluded(field *model.MetaData) bool

IsFieldExcluded returns weather a field will be excluded. Fields will be excluded, if their selector matches one in LabeledModelView.ExcludedFields. A field is also excluded when its parent field is excluded. This function is not restricted to model.Value, it works with all struct fields. This way a whole sub struct an be excluded by adding its selector to LabeledModelView.ExcludedFields.

func (*LabeledModelView) Render

func (self *LabeledModelView) Render(ctx *Context) (err error)
type Link struct {
	ViewBaseWithId
	Class      string
	Model      LinkModel
	NewWindow  bool
	UseLinkTag bool
}

Link represents an HTML <a> or <link> element depending on UseLinkTag. Content and title of the Model will only be rendered for <a>.

func A

func A(url interface{}, content ...interface{}) *Link

A creates <a href="url">content</a>

func A_blank

func A_blank(url interface{}, content ...interface{}) *Link

A_blank creates <a href="url" target="_blank">content</a>

func A_blank_nofollow

func A_blank_nofollow(url interface{}, content ...interface{}) *Link

A_blank_nofollow creates <a href="url" target="_blank" rel="nofollow">content</a>

func A_nofollow

func A_nofollow(url interface{}, content ...interface{}) *Link

A_nofollow creates <a href="url" rel="nofollow">content</a>

func StylesheetLink(url string) *Link

StylesheetLink creates <link rel='stylesheet' href='url'>

func (*Link) Render

func (self *Link) Render(ctx *Context) (err error)

func (*Link) URL

func (self *Link) URL(ctx *Context) string

type LinkModel

type LinkModel interface {
	URL
	LinkContent(ctx *Context) View
	LinkTitle(ctx *Context) string
	LinkRel(ctx *Context) string
}

func NewLinkModel

func NewLinkModel(url interface{}, content ...interface{}) LinkModel

func NewLinkModelRel

func NewLinkModelRel(url interface{}, rel string, content ...interface{}) LinkModel

type List

type List struct {
	ViewBaseWithId
	Model       ListModel
	Ordered     bool
	OrderOffset uint
	Class       string
}

TODO definition list

func OL

func OL(items ...interface{}) *List

OL is a shortcut to create an ordered list by wrapping items as HTML views. NewView will be called for every passed item.

Example:

OL("red", "green", "blue")
OL(A(url1, "First Link"), A(url2, "Second Link"))

func UL

func UL(items ...interface{}) *List

UL is a shortcut to create an unordered list by wrapping items as HTML views. NewView will be called for every passed item.

Example:

UL("red", "green", "blue")
UL(A(url1, "First Link"), A(url2, "Second Link"))

func (*List) Render

func (self *List) Render(ctx *Context) (err error)

type ListModel

type ListModel interface {
	NumItems() int
	ItemView(index int, ctx *Context) (view View, err error)
}
type Menu struct {
	ViewBaseWithId
	Class           string
	ItemClass       string
	ActiveItemClass string
	BetweenItems    string
	Items           []LinkModel
	Reverse         bool
}
func (self *Menu) Render(ctx *Context) (err error)

type Middleware

type Middleware interface {
	PreRender(ctx *Context) (abort bool)
	PostRender(response *Response, html string, err error) (newHtml string, newErr error)
}

type ModalDialog

type ModalDialog struct {
	ViewBaseWithId
	Class   string
	Style   string
	Content View
}

func (*ModalDialog) IterateChildren

func (self *ModalDialog) IterateChildren(callback IterateChildrenCallback)

func (*ModalDialog) OpenButton

func (self *ModalDialog) OpenButton(text string) *Button

func (*ModalDialog) OpenScript

func (self *ModalDialog) OpenScript() string

func (*ModalDialog) Render

func (self *ModalDialog) Render(ctx *Context) (err error)

type ModelBlobController

type ModelBlobController struct{}

func (ModelBlobController) NewInput

func (self ModelBlobController) NewInput(withLabel bool, metaData *model.MetaData, form *Form) (input View, err error)

func (ModelBlobController) SetValue

func (self ModelBlobController) SetValue(value string, ctx *Context, metaData *model.MetaData, form *Form) error

func (ModelBlobController) Supports

func (self ModelBlobController) Supports(metaData *model.MetaData, form *Form) bool

type ModelBoolController

type ModelBoolController struct{}

func (ModelBoolController) NewInput

func (self ModelBoolController) NewInput(withLabel bool, metaData *model.MetaData, form *Form) (input View, err error)

func (ModelBoolController) SetValue

func (self ModelBoolController) SetValue(value string, ctx *Context, metaData *model.MetaData, form *Form) error

func (ModelBoolController) Supports

func (self ModelBoolController) Supports(metaData *model.MetaData, form *Form) bool

type ModelChoiceController

type ModelChoiceController struct {
	SetModelValueControllerBase
}

func (ModelChoiceController) NewInput

func (self ModelChoiceController) NewInput(withLabel bool, metaData *model.MetaData, form *Form) (input View, err error)

func (ModelChoiceController) Supports

func (self ModelChoiceController) Supports(metaData *model.MetaData, form *Form) bool

type ModelDateController

type ModelDateController struct {
	SetModelValueControllerBase
}

func (ModelDateController) NewInput

func (self ModelDateController) NewInput(withLabel bool, metaData *model.MetaData, form *Form) (input View, err error)

func (ModelDateController) Supports

func (self ModelDateController) Supports(metaData *model.MetaData, form *Form) bool

type ModelDateTimeController

type ModelDateTimeController struct {
	SetModelValueControllerBase
}

func (ModelDateTimeController) NewInput

func (self ModelDateTimeController) NewInput(withLabel bool, metaData *model.MetaData, form *Form) (input View, err error)

func (ModelDateTimeController) Supports

func (self ModelDateTimeController) Supports(metaData *model.MetaData, form *Form) bool

type ModelDynamicChoiceController

type ModelDynamicChoiceController struct {
	SetModelValueControllerBase
}

func (ModelDynamicChoiceController) NewInput

func (self ModelDynamicChoiceController) NewInput(withLabel bool, metaData *model.MetaData, form *Form) (input View, err error)

func (ModelDynamicChoiceController) Supports

func (self ModelDynamicChoiceController) Supports(metaData *model.MetaData, form *Form) bool

type ModelEmailController

type ModelEmailController struct {
	SetModelValueControllerBase
}

func (ModelEmailController) NewInput

func (self ModelEmailController) NewInput(withLabel bool, metaData *model.MetaData, form *Form) (View, error)

func (ModelEmailController) Supports

func (self ModelEmailController) Supports(metaData *model.MetaData, form *Form) bool

type ModelFileController

type ModelFileController struct{}

func (ModelFileController) NewInput

func (self ModelFileController) NewInput(withLabel bool, metaData *model.MetaData, form *Form) (input View, err error)

func (ModelFileController) SetValue

func (self ModelFileController) SetValue(value string, ctx *Context, metaData *model.MetaData, form *Form) error

func (ModelFileController) Supports

func (self ModelFileController) Supports(metaData *model.MetaData, form *Form) bool

type ModelFloatController

type ModelFloatController struct {
	SetModelValueControllerBase
}

func (ModelFloatController) NewInput

func (self ModelFloatController) NewInput(withLabel bool, metaData *model.MetaData, form *Form) (input View, err error)

func (ModelFloatController) Supports

func (self ModelFloatController) Supports(metaData *model.MetaData, form *Form) bool

type ModelIntController

type ModelIntController struct {
	SetModelValueControllerBase
}

func (ModelIntController) NewInput

func (self ModelIntController) NewInput(withLabel bool, metaData *model.MetaData, form *Form) (input View, err error)

func (ModelIntController) Supports

func (self ModelIntController) Supports(metaData *model.MetaData, form *Form) bool

type ModelIteratorTableView

type ModelIteratorTableView struct {
	ViewBase
	Class             string
	Caption           string
	GetModelIterator  GetModelIteratorFunc
	GetHeaderRowViews func(ctx *Context) (views Views, err error)
	// GetRowModel returns the model used GetRowViews.
	// Only return the same object if you know exactly what you are doing.
	// To be on the safe side, return a new model instance at every call.
	GetRowModel func(ctx *Context) (model interface{}, err error)
	GetRowViews func(row int, rowModel interface{}, ctx *Context) (views Views, err error)
	// contains filtered or unexported fields
}

func (*ModelIteratorTableView) IterateChildren

func (self *ModelIteratorTableView) IterateChildren(callback IterateChildrenCallback)

func (*ModelIteratorTableView) Render

func (self *ModelIteratorTableView) Render(ctx *Context) (err error)

type ModelIteratorView

type ModelIteratorView struct {
	ViewBase
	GetModelIterator GetModelIteratorFunc
	// GetModel returns the model used GetModelIteratorView.
	// Only return the same object if you know exactly what you are doing.
	// To be on the safe side, return a new model instance at every call.
	GetModel     func(ctx *Context) (model interface{}, err error)
	GetModelView GetModelIteratorViewFunc // nil Views will be ignored
}

func (*ModelIteratorView) Render

func (self *ModelIteratorView) Render(ctx *Context) (err error)

type ModelMultipleChoiceController

type ModelMultipleChoiceController struct{}

func (ModelMultipleChoiceController) NewInput

func (self ModelMultipleChoiceController) NewInput(withLabel bool, metaData *model.MetaData, form *Form) (input View, err error)

func (ModelMultipleChoiceController) SetValue

func (self ModelMultipleChoiceController) SetValue(value string, ctx *Context, metaData *model.MetaData, form *Form) error

func (ModelMultipleChoiceController) Supports

func (self ModelMultipleChoiceController) Supports(metaData *model.MetaData, form *Form) bool

type ModelPasswordController

type ModelPasswordController struct {
	SetModelValueControllerBase
}

func (ModelPasswordController) NewInput

func (self ModelPasswordController) NewInput(withLabel bool, metaData *model.MetaData, form *Form) (input View, err error)

func (ModelPasswordController) Supports

func (self ModelPasswordController) Supports(metaData *model.MetaData, form *Form) bool

type ModelPhoneController

type ModelPhoneController struct {
	SetModelValueControllerBase
}

func (ModelPhoneController) NewInput

func (self ModelPhoneController) NewInput(withLabel bool, metaData *model.MetaData, form *Form) (input View, err error)

func (ModelPhoneController) Supports

func (self ModelPhoneController) Supports(metaData *model.MetaData, form *Form) bool

type ModelRichTextController

type ModelRichTextController struct {
	SetModelValueControllerBase
}

func (ModelRichTextController) NewInput

func (self ModelRichTextController) NewInput(withLabel bool, metaData *model.MetaData, form *Form) (input View, err error)

func (ModelRichTextController) Supports

func (self ModelRichTextController) Supports(metaData *model.MetaData, form *Form) bool

type ModelStringController

type ModelStringController struct {
	SetModelValueControllerBase
}

func (ModelStringController) NewInput

func (self ModelStringController) NewInput(withLabel bool, metaData *model.MetaData, form *Form) (input View, err error)

func (ModelStringController) Supports

func (self ModelStringController) Supports(metaData *model.MetaData, form *Form) bool

type ModelTextController

type ModelTextController struct {
	SetModelValueControllerBase
}

func (ModelTextController) NewInput

func (self ModelTextController) NewInput(withLabel bool, metaData *model.MetaData, form *Form) (input View, err error)

func (ModelTextController) Supports

func (self ModelTextController) Supports(metaData *model.MetaData, form *Form) bool

type ModelUrlController

type ModelUrlController struct {
	SetModelValueControllerBase
}

func (ModelUrlController) NewInput

func (self ModelUrlController) NewInput(withLabel bool, metaData *model.MetaData, form *Form) (View, error)

func (ModelUrlController) Supports

func (self ModelUrlController) Supports(metaData *model.MetaData, form *Form) bool

type MongoRefController

type MongoRefController struct {
	// RefSelector selects for which mongo.Ref fields this
	// FormFieldController should be used.
	// An empty string selects all mongo.Ref in the form model.
	RefSelector string

	// LabelSelector is a selector into the referenced documents to retrieve
	// the labels for the documents.
	// If labelSelector is an empty string, then a struct tag `view:"optionsLabel="`
	// will be used or DocumentLabelSelector from the mongo.Ref's collection.
	LabelSelectors []string

	// OptionsIterator iterates the possible documents for the mongo.Ref.
	// If options is nil, then all documents of the mongo.Ref's collection are used
	OptionsIterator model.Iterator
}

func (*MongoRefController) NewInput

func (self *MongoRefController) NewInput(withLabel bool, metaData *model.MetaData, form *Form) (input View, err error)

func (*MongoRefController) SetValue

func (self *MongoRefController) SetValue(value string, ctx *Context, metaData *model.MetaData, form *Form) error

func (*MongoRefController) Supports

func (self *MongoRefController) Supports(metaData *model.MetaData, form *Form) bool

type MultiViewsListModel

type MultiViewsListModel []Views

func (MultiViewsListModel) ItemView

func (self MultiViewsListModel) ItemView(index int, ctx *Context) (view View, err error)

func (MultiViewsListModel) NumItems

func (self MultiViewsListModel) NumItems() int

type NotFound

type NotFound string

func (NotFound) Error

func (self NotFound) Error() string

type NotFoundView

type NotFoundView struct {
	ViewBase
	Message string
}

func (*NotFoundView) Render

func (self *NotFoundView) Render(ctx *Context) (err error)

type OnFormSubmitFunc

type OnFormSubmitFunc func(form *Form, formModel interface{}, ctx *Context) (message string, redirect URL, err error)

func OnFormSubmit

func OnFormSubmit(onSubmitFunc interface{}) OnFormSubmitFunc

OnFormSubmit wraps onSubmitFunc as a OnFormSubmitFunc with the arguments and results of OnFormSubmitFunc optional for onSubmitFunc. The order of the arguments and results is also free to choose.

func OnFormSubmitSaveModelAndRedirect

func OnFormSubmitSaveModelAndRedirect(redirectURL URL) OnFormSubmitFunc

type OnFormValidationErrorFunc

type OnFormValidationErrorFunc func(form *Form, formModel interface{}, fieldValidationErrors, generalValidationErrors []error) (revalidate bool)

type Page

type Page struct {
	Template

	// Called before any other function when rendering the page
	OnPreRender func(page *Page, ctx *Context) (err error)

	// Writes the head title tag
	Title Renderer

	// Writes the head meta description tag
	MetaDescription Renderer

	// Content of the head meta viewport tag,
	// Config.Page.DefaultMetaViewport will be used if ""
	MetaViewport string

	// Write additional HTML head content
	AdditionalHead Renderer

	// Write head content before the stylesheet link
	PreCSS Renderer

	// stylesheet link URL
	CSS URL

	// Write head content after the stylesheet link
	PostCSS Renderer

	// Write scripts as last element of the HTML head
	HeadScripts Renderer

	// HTML body content. Will be wrapped by a div with class="container"
	Content View

	// Write scripts after body content
	Scripts Renderer

	// That way of linking to favicons my be removed in the future:
	Favicon16x16URL   string
	Favicon57x57URL   string
	Favicon72x72URL   string
	Favicon114x114URL string
	Favicon129x129URL string
	// contains filtered or unexported fields
}

Page is the basis to render complete HTML pages. An arbitrary View or ViewWithURL can be used to render other text formats like CSS or JSON.

A HTML5 Boilerplate template is used by default. See:

  • gostart/templates/html5boilerplate.html
  • gostart/static/css/html5boilerplate/normalize.css
  • gostart/static/css/html5boilerplate/poststyle.css

Note: In the current version Mustache is always used as templates system. This will be changed to the Go v1 template system in the Go v1 syntax release.

Most HTML head and script specific text is written by Renderer functions that receive the request context as an argument. That way the content can be created dynamically.

Wrapper functions for static content are provided for convenience. See functions under Renderer below.

Example:

&Page{WriteTitle: func(response *Response, writer io.Writer) (err error) {
	writer.Write([]byte("Could be a dynamic title"))
	return nil
}}

&Page{WriteTitle: PageTitle("Static Title")}

To avoid reading the same data multiple times from the database in Renderer or dynamic views in the content structure, OnPreRender can be used to query and set page wide data only once at the request context.Data.

Example:

&Page{
	OnPreRender: func(page *Page, ctx *Context) (err error) {
		context.Data = &MyPerPageData{SomeText: "Hello World!"}
	},
	Content: DynamicView(
		func(ctx *Context) (view View, err error) {
			myPerPageData := context.Data.(*MyPerPageData)
			return HTML(myPerPageData.SomeText), nil
		},
	),
}

func (*Page) Init

func (self *Page) Init(thisView View)

func (*Page) IterateChildren

func (self *Page) IterateChildren(callback IterateChildrenCallback)

func (*Page) LinkContent

func (self *Page) LinkContent(ctx *Context) View

Implements the LinkModel interface

func (*Page) LinkRel

func (self *Page) LinkRel(ctx *Context) string

Implements the LinkModel interface

func (*Page) LinkTitle

func (self *Page) LinkTitle(ctx *Context) string

Implements the LinkModel interface

func (*Page) Render

func (self *Page) Render(ctx *Context) (err error)

func (*Page) SetPath

func (self *Page) SetPath(path string)

func (*Page) URL

func (self *Page) URL(ctx *Context) string

Implements the URL and LinkModel interface

type PageConfiguration

type PageConfiguration struct {
	Template              string
	DefaultAdditionalHead Renderer // will be called after WriteTitle
	DefaultCSS            string
	DefaultMetaViewport   string
	DefaultHeadScripts    Renderer      // write scripts as last element of the HTML head
	DefaultScripts        Renderer      // will be called if Page.WriteScripts is nil
	PostScripts           Renderer      // will always be called after Page.WriteScripts
	DefaultAuth           Authenticator // Will be used for pages with Page.NeedsAuth == true
}
type PageLink struct {
	Page    **Page
	Content View
	Title   string
	Rel     string
}
func NewPageLink(page **Page, title string) *PageLink

func (*PageLink) LinkContent

func (self *PageLink) LinkContent(ctx *Context) View

func (*PageLink) LinkRel

func (self *PageLink) LinkRel(ctx *Context) string

func (*PageLink) LinkTitle

func (self *PageLink) LinkTitle(ctx *Context) string

func (*PageLink) URL

func (self *PageLink) URL(ctx *Context) string

type Paragraph

type Paragraph struct {
	ViewBaseWithId
	Class   string
	Content View
}

func (*Paragraph) IterateChildren

func (self *Paragraph) IterateChildren(callback IterateChildrenCallback)

func (*Paragraph) Render

func (self *Paragraph) Render(ctx *Context) (err error)

type PermanentRedirect

type PermanentRedirect string

func (PermanentRedirect) Error

func (self PermanentRedirect) Error() string

type Redirect

type Redirect string

func (Redirect) Error

func (self Redirect) Error() string

type RedirectView

type RedirectView struct {
	ViewBase
	URL       string
	Permanent bool
}

If rendered, this view will cause a HTTP redirect.

func (*RedirectView) Render

func (self *RedirectView) Render(ctx *Context) (err error)

type Render

type Render func(ctx *Context) error

func (Render) Render

func (self Render) Render(ctx *Context) error

type RenderView

type RenderView func(ctx *Context) error

RenderView implements all View methods for a View.Render compatible function.

Example:

renderView := RenderView(
	func(ctx *Context) error {
		writer.Write([]byte("<html><body>Any Content</body></html>"))
		return nil
	},
)

func RenderViewBindURLArgs

func RenderViewBindURLArgs(renderFunc interface{}) RenderView

RenderViewBindURLArgs creates a View where renderFunc is called from View.Render with Context.URLArgs converted to function arguments. The first renderFunc argument can be of type *Context, but this is optional. All further arguments will be converted from the corresponding Context.URLArgs string to their actual type. Conversion to integer, float, string and bool arguments are supported. If there are more URLArgs than function args, then supernumerous URLArgs will be ignored. If there are less URLArgs than function args, then the function args will receive their types zero value. The result of renderFunc can be empty or of type error.

Example:

view.RenderViewBindURLArgs(func(i int, b bool) {
	ctx.Response.Printf("ctx.URLArgs[0]: %d, ctx.URLArgs[1]: %b", i, b)
})

func (RenderView) ID

func (self RenderView) ID() string

func (RenderView) Init

func (self RenderView) Init(thisView View)

func (RenderView) IterateChildren

func (self RenderView) IterateChildren(callback IterateChildrenCallback)

func (RenderView) Render

func (self RenderView) Render(ctx *Context) error

type Renderer

type Renderer interface {
	Render(ctx *Context) error
}

func FilterPortRenderer

func FilterPortRenderer(port uint16, renderer Renderer) Renderer

FilterPortRenderer calls renderer.Render only if the request is made to a specific port

func IndirectRenderer

func IndirectRenderer(rendererPtr *Renderer) Renderer

IndirectRenderer takes the pointer to a Renderer variable and dereferences it when the returned Renderer's Render method is called. Used to break dependency cycles of variable initializations by using a pointer to a variable instead of its value.

func NonProductionServerRenderer

func NonProductionServerRenderer(renderer Renderer) Renderer

NotProductionServerRenderer returns renderer if view.Config.IsProductionServer is false, else nil which is a valid value for a Renderer.

func ProductionServerRenderer

func ProductionServerRenderer(renderer Renderer) Renderer

ProductionServerRenderer returns renderer if view.Config.IsProductionServer is true, else nil which is a valid value for a Renderer.

type Renderers

type Renderers []Renderer

func (Renderers) Render

func (self Renderers) Render(ctx *Context) error

type Request

type Request struct {
	*http.Request

	Params map[string]string
	// contains filtered or unexported fields
}

func (*Request) AddProtocolAndHostToURL

func (self *Request) AddProtocolAndHostToURL(url string) string

AddProtocolAndHostToURL adds the protocol (http:// or https://) and request host (domain or IP) to an URL if not present.

func (*Request) GetSecureCookie

func (self *Request) GetSecureCookie(name string) (string, bool)

func (*Request) ParseUserAgent

func (self *Request) ParseUserAgent() (renderer string, version utils.VersionTuple, err error)

todo: all browsers

func (*Request) Port

func (self *Request) Port() uint16

func (*Request) URLString

func (self *Request) URLString() string

URL returns the complete URL of the request including protocol and host.

type Response

type Response struct {
	Session *Session

	// XML allowes the Response to be used as utils.XMLWriter
	XML *utils.XMLWriter
	// contains filtered or unexported fields
}

func (*Response) Abort

func (self *Response) Abort(status int, body string)

func (*Response) AuthorizationRequired401

func (self *Response) AuthorizationRequired401()

func (*Response) Bytes

func (self *Response) Bytes() []byte

func (*Response) ContentDispositionAttachment

func (self *Response) ContentDispositionAttachment(filename string)

ContentDispositionAttachment makes the webbrowser open a "Save As.." dialog for the response.

func (*Response) Forbidden403

func (self *Response) Forbidden403(message string)

func (*Response) Header

func (self *Response) Header() http.Header

func (*Response) NotFound404

func (self *Response) NotFound404(message string)

func (*Response) NotModified304

func (self *Response) NotModified304()

func (*Response) PopBody

func (self *Response) PopBody() (bufferData []byte)

PopBody pops the buffer of the response body from the stack and returns its content.

func (*Response) PopBodyString

func (self *Response) PopBodyString() (bufferData string)

PopBodyString pops the buffer of the response body from the stack and returns its content as string.

func (*Response) Printf

func (self *Response) Printf(format string, args ...interface{}) (n int, err error)

func (*Response) PushBody

func (self *Response) PushBody()

PushBody pushes the buffer of the response body on a stack and sets a new empty buffer. This can be used to render intermediate text results. Note: Only the response body is pushed, all other state changes like setting headers will affect the final response.

func (*Response) RedirectPermanently301

func (self *Response) RedirectPermanently301(url string)

func (*Response) RedirectTemporary302

func (self *Response) RedirectTemporary302(url string)

func (*Response) RequireHeadScript

func (self *Response) RequireHeadScript(script string, priority int)

RequireHeadScript adds dynamic JavaScript to the page. Multiple dynamic entries will be sorted by priority. The dynamic JavaScript will be inserted after the regular head-scripts of the page. If script does not start with "<script", then the script string will be wrapped with a script tag.

Use this feature to dynamically add JavaScript to the page if the HTML content requires it.

func (*Response) RequireHeadScriptURL

func (self *Response) RequireHeadScriptURL(url string, priority int)

RequireHeadScriptURL adds a dynamic JavaScript link to the page. Multiple dynamic entries will be sorted by priority. The dynamic JavaScript will be inserted after the regular head-scripts of the page.

Use this feature to dynamically add JavaScript to the page if the HTML content requires it.

func (*Response) RequireScript

func (self *Response) RequireScript(script string, priority int)

RequireScript adds dynamic JavaScript to the page. Multiple dynamic entries will be sorted by priority. The dynamic JavaScript will be inserted after the regular scripts near the end of the page. If script does not start with "<script", then the script string will be wrapped with a script tag.

Use this feature to dynamically add JavaScript to the page if the HTML content requires it.

func (*Response) RequireScriptURL

func (self *Response) RequireScriptURL(url string, priority int)

RequireScriptURL adds a dynamic JavaScript link to the page. Multiple dynamic entries will be sorted by priority. The dynamic JavaScript will be inserted after the regular scripts near the end of the page.

Use this feature to dynamically add JavaScript to the page if the HTML content requires it.

func (*Response) RequireStyle

func (self *Response) RequireStyle(css string, priority int)

RequireStyle adds dynamic CSS content to the page. Multiple dynamic entries will be sorted by priority. Dynamic CSS will be inserted after the regular CSS of the page. If css does not start with "<style", then the css string will be wrapped with a style tag.

Use this feature to dynamically add CSS to the page if the HTML content requires it.

func (*Response) RequireStyleURL

func (self *Response) RequireStyleURL(url string, priority int)

RequireStyleURL adds a dynamic CSS link to the page. Multiple dynamic entries will be sorted by priority. Dynamic CSS will be inserted after the regular CSS of the page.

Use this feature to dynamically add CSS to the page if the HTML content requires it.

func (*Response) SetContentTypeByExt

func (self *Response) SetContentTypeByExt(ext string)

func (*Response) SetSecureCookie

func (self *Response) SetSecureCookie(name string, val string, age int64, path string)

func (*Response) String

func (self *Response) String() string

func (*Response) Write

func (self *Response) Write(p []byte) (n int, err error)

func (*Response) WriteByte

func (self *Response) WriteByte(c byte) error

func (*Response) WriteString

func (self *Response) WriteString(s string) (n int, err error)

type RichTextArea

type RichTextArea struct {
	ViewBaseWithId
	Text                 string
	Name                 string
	Cols                 int
	Rows                 int
	Readonly             bool
	Disabled             bool
	TabIndex             int
	Class                string
	Placeholder          string
	ToolbarStylesheetURL string
}

func (*RichTextArea) Render

func (self *RichTextArea) Render(ctx *Context) (err error)

We use https://github.com/xing/wysihtml5/ as open source rich text editor

type RichTextConfiguration

type RichTextConfiguration struct {
	DefaultToolbar string
	ToolbarCSS     string
	EditorCSS      string
	UseGlobalCSS   bool
}

func (*RichTextConfiguration) SetStylesheet

func (self *RichTextConfiguration) SetStylesheet(url string)

type Select

type Select struct {
	ViewBaseWithId
	Model    SelectModel
	Name     string
	Size     int // 0 shows all items, 1 shows a dropdownbox, other values show size items
	Class    string
	Disabled bool
}

func (*Select) Render

func (self *Select) Render(ctx *Context) (err error)

type SelectModel

type SelectModel interface {
	NumOptions() int
	Value(index int) string
	Selected(index int) bool
	Disabled(index int) bool
	RenderLabel(index int, ctx *Context) (err error)
}

type Session

type Session struct {
	Tracker   SessionTracker
	DataStore SessionDataStore
	Ctx       *Context
	// contains filtered or unexported fields
}

func (*Session) Data

func (self *Session) Data(out interface{}) (ok bool, err error)

SessionData returns all session data in out.

func (*Session) DeleteData

func (self *Session) DeleteData() (err error)

DeleteSessionData deletes all session data.

func (*Session) DeleteID

func (self *Session) DeleteID()

func (*Session) ID

func (self *Session) ID() string

ID returns the id of the session or an empty string. It's valid to call this method on a nil pointer.

func (*Session) SetData

func (self *Session) SetData(data interface{}) (err error)

SetSessionData sets all session data.

func (*Session) SetID

func (self *Session) SetID(id string)

type SessionDataStore

type SessionDataStore interface {
	Get(ctx *Context, data interface{}) (ok bool, err error)
	Set(ctx *Context, data interface{}) (err error)
	Delete(ctx *Context) (err error)
}

func NewCookieSessionDataStore

func NewCookieSessionDataStore() SessionDataStore

type SessionTracker

type SessionTracker interface {
	ID(ctx *Context) (id string)
	SetID(ctx *Context, id string)
	DeleteID(ctx *Context)
}

type SetModelValueControllerBase

type SetModelValueControllerBase struct{}

func (SetModelValueControllerBase) SetValue

func (self SetModelValueControllerBase) SetValue(value string, ctx *Context, metaData *model.MetaData, form *Form) error

type ShortTag

type ShortTag struct {
	ViewBase
	Tag     string
	Class   string
	Attribs map[string]string
	Content View
}

ShortTag represents an arbitrary HTML element. It has a smaller footprint than Tag.

func (*ShortTag) IterateChildren

func (self *ShortTag) IterateChildren(callback IterateChildrenCallback)

func (*ShortTag) Render

func (self *ShortTag) Render(ctx *Context) (err error)

type Span

type Span struct {
	ViewBaseWithId
	Class   string
	Content View
}

Span represents a HTML span element.

func SPAN

func SPAN(class string, content ...interface{}) *Span

DIV creates <span class="class">content</span>

func (*Span) IterateChildren

func (self *Span) IterateChildren(callback IterateChildrenCallback)

func (*Span) Render

func (self *Span) Render(ctx *Context) (err error)

type StandardFormLayout

type StandardFormLayout struct {
	DefaultInputSize      int
	DefaultTableInputSize int
}

StandardFormLayout.

CSS needed for StandardFormLayout:

form label:after {
	content: ":";
}

form input[type=checkbox] + label:after {
	content: "";
}

Additional CSS for labels above input fields (except checkboxes):

form label {
	display: block;
}

form input[type=checkbox] + label {
	display: inline;
}

DIV classes for coloring:

form .required {}
form .error {}
form .success {}

func (*StandardFormLayout) BeginFormContent

func (self *StandardFormLayout) BeginFormContent(form *Form, ctx *Context, formContent *Views) error

func (*StandardFormLayout) BeginIndexedFields

func (self *StandardFormLayout) BeginIndexedFields(indexedFields *model.MetaData, form *Form, ctx *Context, formContent *Views) error

func (*StandardFormLayout) BeginNamedFields

func (self *StandardFormLayout) BeginNamedFields(namedFields *model.MetaData, form *Form, ctx *Context, formContent *Views) error

func (*StandardFormLayout) EndFormContent

func (self *StandardFormLayout) EndFormContent(fieldValidationErrs, generalValidationErrs []error, form *Form, ctx *Context, formContent *Views) error

func (*StandardFormLayout) EndIndexedFields

func (self *StandardFormLayout) EndIndexedFields(indexedFields *model.MetaData, validationErr error, form *Form, ctx *Context, formContent *Views) error

func (*StandardFormLayout) EndNamedFields

func (self *StandardFormLayout) EndNamedFields(namedFields *model.MetaData, validationErr error, form *Form, ctx *Context, formContent *Views) error

func (*StandardFormLayout) GetDefaultInputSize

func (self *StandardFormLayout) GetDefaultInputSize(metaData *model.MetaData) int

func (*StandardFormLayout) IndexedField

func (self *StandardFormLayout) IndexedField(field *model.MetaData, validationErr error, form *Form, ctx *Context, formContent *Views) error

func (*StandardFormLayout) NamedField

func (self *StandardFormLayout) NamedField(field *model.MetaData, validationErr error, form *Form, ctx *Context, formContent *Views) error

func (*StandardFormLayout) NewAddButton

func (self *StandardFormLayout) NewAddButton(onclick string, form *Form) View

func (*StandardFormLayout) NewDownButton

func (self *StandardFormLayout) NewDownButton(disabled bool, onclick string, form *Form) View

func (*StandardFormLayout) NewFieldDescrtiption

func (self *StandardFormLayout) NewFieldDescrtiption(description string, form *Form) View

func (*StandardFormLayout) NewFieldErrorMessage

func (self *StandardFormLayout) NewFieldErrorMessage(message string, metaData *model.MetaData, form *Form) View

func (*StandardFormLayout) NewGeneralErrorMessage

func (self *StandardFormLayout) NewGeneralErrorMessage(message string, form *Form) View

func (*StandardFormLayout) NewHiddenInput

func (self *StandardFormLayout) NewHiddenInput(metaData *model.MetaData, form *Form) (View, error)

func (*StandardFormLayout) NewRemoveButton

func (self *StandardFormLayout) NewRemoveButton(onclick string, form *Form) View

func (*StandardFormLayout) NewSubmitButton

func (self *StandardFormLayout) NewSubmitButton(text, confirmationMessage string, form *Form) *SubmitButton

func (*StandardFormLayout) NewSuccessMessage

func (self *StandardFormLayout) NewSuccessMessage(message string, form *Form) View

func (*StandardFormLayout) NewTableHeader

func (self *StandardFormLayout) NewTableHeader(metaData *model.MetaData, form *Form) (View, error)

func (*StandardFormLayout) NewUpButton

func (self *StandardFormLayout) NewUpButton(disabled bool, onclick string, form *Form) View

func (*StandardFormLayout) SubmitError

func (self *StandardFormLayout) SubmitError(message string, form *Form, ctx *Context, formContent *Views) error

func (*StandardFormLayout) SubmitSuccess

func (self *StandardFormLayout) SubmitSuccess(message string, form *Form, ctx *Context, formContent *Views) error

type StaticFile

type StaticFile struct {
	ViewWithURLBase
	Filename string
	// Will be set automatically from Filename if empty
	ContentTypeExt string
	// contains filtered or unexported fields
}

StaticFile renders a static file. The output is cached in memory but changes to the file on the filesystem cause the the cache to be rebuilt.

func NewStaticFile

func NewStaticFile(filename string) *StaticFile

func (*StaticFile) Render

func (self *StaticFile) Render(ctx *Context) (err error)
type StringLink struct {
	Url     string
	Content View   // If nil, then self.LinkTitle() will be used
	Title   string // If "", then self.URL will be used
	Rel     string
}

StringLink implements the LinkModel interface with string values for Url, Title, and Rel.

func (*StringLink) LinkContent

func (self *StringLink) LinkContent(ctx *Context) View

func (*StringLink) LinkRel

func (self *StringLink) LinkRel(ctx *Context) string

func (*StringLink) LinkTitle

func (self *StringLink) LinkTitle(ctx *Context) string

func (*StringLink) URL

func (self *StringLink) URL(ctx *Context) string

type StringURL

type StringURL string

StringURL implements the URL interface for a URL string.

func (StringURL) URL

func (self StringURL) URL(ctx *Context) string

type StringsSelectModel

type StringsSelectModel struct {
	Options        []string
	SelectedOption string
}

func (*StringsSelectModel) Disabled

func (self *StringsSelectModel) Disabled(index int) bool

func (*StringsSelectModel) NumOptions

func (self *StringsSelectModel) NumOptions() int

func (*StringsSelectModel) RenderLabel

func (self *StringsSelectModel) RenderLabel(index int, ctx *Context) (err error)

func (*StringsSelectModel) Selected

func (self *StringsSelectModel) Selected(index int) bool

func (*StringsSelectModel) Value

func (self *StringsSelectModel) Value(index int) string

type SubmitButton

type SubmitButton struct {
	ViewBaseWithId
	Name           string
	Value          interface{}
	Class          string
	Disabled       bool
	TabIndex       int
	OnClick        string
	OnClickConfirm string // Will add a confirmation dialog for onclick
}

func (*SubmitButton) Render

func (self *SubmitButton) Render(ctx *Context) (err error)

type Table

type Table struct {
	ViewBaseWithId
	Model     TableModel
	Class     string
	Caption   string
	HeaderRow bool
}

func (*Table) Render

func (self *Table) Render(ctx *Context) (err error)

type TableModel

type TableModel interface {
	Rows() int
	Columns() int
	CellView(row int, column int, ctx *Context) (view View, err error)
}

type Tag

type Tag struct {
	ViewBaseWithId
	Tag        string
	Content    View
	Class      string
	Attribs    map[string]string
	ExtraClose bool
}

Tag represents an arbitrary HTML element.

func (*Tag) IterateChildren

func (self *Tag) IterateChildren(callback IterateChildrenCallback)

func (*Tag) Render

func (self *Tag) Render(ctx *Context) (err error)

type Template

type Template struct {
	ViewWithURLBase
	Filename       string // Will set file extension at ContentType
	Text           string
	ContentTypeExt string
	GetContext     GetTemplateContextFunc
	TemplateSystem templatesystem.Implementation // If nil, self.App.Config.TemplateSystem is used
	// contains filtered or unexported fields
}

func NewTemplate

func NewTemplate(filename string, getContext GetTemplateContextFunc) *Template

func (*Template) Render

func (self *Template) Render(ctx *Context) (err error)

type TextArea

type TextArea struct {
	ViewBaseWithId
	Text        string
	Name        string
	Cols        int
	Rows        int
	Readonly    bool
	Disabled    bool
	TabIndex    int
	Class       string
	Placeholder string
	Required    bool // HTML5
	Autofocus   bool // HTML5
}

func (*TextArea) Render

func (self *TextArea) Render(ctx *Context) (err error)

type TextField

type TextField struct {
	ViewBaseWithId
	Text        string
	Name        string
	Size        int
	MaxLength   int
	Type        TextFieldType
	TabIndex    int
	Class       string
	Placeholder string
	Title       string
	Readonly    bool
	Disabled    bool
	Required    bool   // HTML5
	Autofocus   bool   // HTML5
	Pattern     string // HTML5
}

func (*TextField) Render

func (self *TextField) Render(ctx *Context) (err error)

func (*TextField) SetRequired

func (self *TextField) SetRequired(required bool)

type TextFieldType

type TextFieldType int
const (
	NormalTextField TextFieldType = iota
	PasswordTextField
	EmailTextField
	SearchTextField
)

type TextPreview

type TextPreview struct {
	ViewBase
	PlainText   string
	MaxLength   int
	ShortLength int // Shortened length if len(Text) > MaxLength. If zero, MaxLength will be used
	MoreLink    LinkModel
}

func (*TextPreview) Render

func (self *TextPreview) Render(ctx *Context) (err error)

type URL

type URL interface {
	URL(ctx *Context) string
}

URL is an interface to return URL strings depending on the request path args.

func IndirectURL

func IndirectURL(urlPtr interface{}) URL

IndirectURL encapsulates pointers to URL implementations. To break circular dependencies, addresses of URL implementing variables can be passed to this function that encapsulates it with an URL implementation that dereferences the pointers at runtime.

func OnFormSubmitSaveModel

func OnFormSubmitSaveModel(form *Form, formModel interface{}, ctx *Context) (msg string, url URL, err error)
type URLLink struct {
	Url     URL
	Content View   // If is nil, then self.LinkTitle() will be used
	Title   string // If is "", then self.URL will be used
	Rel     string
}

URLLink implements the LinkModel interface with a reference to a URL and string values for Title and Rel.

func (*URLLink) LinkContent

func (self *URLLink) LinkContent(ctx *Context) View

func (*URLLink) LinkRel

func (self *URLLink) LinkRel(ctx *Context) string

func (*URLLink) LinkTitle

func (self *URLLink) LinkTitle(ctx *Context) string

func (*URLLink) URL

func (self *URLLink) URL(ctx *Context) string

type URLWithArgs

type URLWithArgs struct {
	Url  URL
	Args []string
}

URLWithArgs binds Args to an URL. Url.URL() will be called with response.URLArgs(Args...)

func NewURLWithArgs

func NewURLWithArgs(url URL, args ...string) *URLWithArgs

func (*URLWithArgs) URL

func (self *URLWithArgs) URL(ctx *Context) string

type ValueLabelSelectModel

type ValueLabelSelectModel struct {
	ValuesAndLabels []string // Values and labels are interleaved starting with a value
	SelectedValue   string
}

func (*ValueLabelSelectModel) Disabled

func (self *ValueLabelSelectModel) Disabled(index int) bool

func (*ValueLabelSelectModel) NumOptions

func (self *ValueLabelSelectModel) NumOptions() int

func (*ValueLabelSelectModel) RenderLabel

func (self *ValueLabelSelectModel) RenderLabel(index int, ctx *Context) (err error)

func (*ValueLabelSelectModel) Selected

func (self *ValueLabelSelectModel) Selected(index int) bool

func (*ValueLabelSelectModel) Value

func (self *ValueLabelSelectModel) Value(index int) string

type Video

type Video struct {
	ViewBaseWithId
	Class  string
	URL    string
	Width  int
	Height int
}

Video shows a Youtube Video, other formats to come.

func (*Video) Render

func (self *Video) Render(ctx *Context) (err error)

type View

type View interface {
	Init(thisView View)
	ID() string
	IterateChildren(callback IterateChildrenCallback)
	// Everything written to out will be discarded if there was an error
	// out.Write() is not expected to return errors like bytes.Buffer
	Render(ctx *Context) (err error)
}

View is the basic interface for all types in the view package. A view can have an id, child views and renders its content to a XMLWriter. nil is permitted as View value and will be ignored while rendering HTML.

func ABBR

func ABBR(longTitle, abbreviation string) View

ABBR creates <abbr title="longTitle">abbreviation</abbr>

func B

func B(content ...interface{}) View

B creates <b>content</b>

func CODE

func CODE(content ...interface{}) View

CODE creates <code>content</code>

func DEL

func DEL(content ...interface{}) View

DEL creates <del>content</del>

func DFN

func DFN(content ...interface{}) View

DFN creates <dfn>content</dfn>

func EM

func EM(content ...interface{}) View

EM creates <em>content</em>

func H1

func H1(content ...interface{}) View

H1 creates <h1>content</h1>

func H2

func H2(content ...interface{}) View

H2 creates <h2>content</h2>

func H3

func H3(content ...interface{}) View

H3 creates <h3>content</h3>

func H4

func H4(content ...interface{}) View

H4 creates <h4>content</h4>

func H5

func H5(content ...interface{}) View

H5 creates <h5>content</h5>

func H6

func H6(content ...interface{}) View

H creates <h6>content</h6>

func I

func I(content ...interface{}) View

I creates <i>content</i>

func JQueryUIAutocomplete

func JQueryUIAutocomplete(domSelector string, options []string, minLength int) View

func JQueryUIAutocompleteFromURL

func JQueryUIAutocompleteFromURL(domSelector string, dataURL URL, minLength int) View

func NewView

func NewView(content interface{}) View

NewView encapsulates content as View. Strings or fmt.Stringer implementations will be HTML escaped. View implementations will be passed through.

func NonProductionServerView

func NonProductionServerView(view View) View

NotProductionServerView returns view if view.Config.IsProductionServer is false, else nil which is a valid value for a View.

func P

func P(content ...interface{}) View

P creates <p>content</p>

func PRE

func PRE(content ...interface{}) View

PRE creates <pre>content</pre>

func ProductionServerView

func ProductionServerView(view View) View

ProductionServerView returns view if view.Config.IsProductionServer is true, else nil which is a valid value for a View.

func Q

func Q(content ...interface{}) View

Q creates <q>content</q>

func RSSLink(title string, url URL) View

RSSLink creates <link rel='alternate' type='application/rss+xml' title='title' href='url'>

func RequireHeadScript

func RequireHeadScript(script string, priority int) View

RequireHeadScript adds dynamic JavaScript to the page. Multiple dynamic entries will be sorted by priority. The dynamic JavaScript will be inserted after the regular head-scripts of the page. If script does not start with "<script", then the script string will be wrapped with a script tag.

Use this feature to dynamically add JavaScript to the page if the HTML content requires it.

func RequireHeadScriptURL

func RequireHeadScriptURL(url string, priority int) View

RequireHeadScriptURL adds a dynamic JavaScript link to the page. Multiple dynamic entries will be sorted by priority. The dynamic JavaScript will be inserted after the regular head-scripts of the page.

Use this feature to dynamically add JavaScript to the page if the HTML content requires it.

func RequireJQuery

func RequireJQuery(priority int) View

func RequireJQueryUI

func RequireJQueryUI(priority int) View

func RequireJQueryUIAutocompleteFromURL

func RequireJQueryUIAutocompleteFromURL(domSelector string, dataURL URL, minLength int, priority int) View

func RequireScript

func RequireScript(script string, priority int) View

RequireScript adds dynamic JavaScript to the page. Multiple dynamic entries will be sorted by priority. The dynamic JavaScript will be inserted after the regular scripts near the end of the page. If script does not start with "<script", then the script string will be wrapped with a script tag.

Use this feature to dynamically add JavaScript to the page if the HTML content requires it.

func RequireScriptURL

func RequireScriptURL(url string, priority int) View

RequireScriptURL adds a dynamic JavaScript link to the page. Multiple dynamic entries will be sorted by priority. The dynamic JavaScript will be inserted after the regular scripts near the end of the page.

Use this feature to dynamically add JavaScript to the page if the HTML content requires it.

func RequireStyle

func RequireStyle(css string, priority int) View

RequireStyle adds dynamic CSS content to the page. Multiple dynamic entries will be sorted by priority. Dynamic CSS will be inserted after the regular CSS of the page. If css does not start with "<style", then the css string will be wrapped with a style tag.

Use this feature to dynamically add CSS to the page if the HTML content requires it.

func RequireStyleURL

func RequireStyleURL(url string, priority int) View

RequireStyleURL adds a dynamic CSS link to the page. Multiple dynamic entries will be sorted by priority. Dynamic CSS will be inserted after the regular CSS of the page.

Use this feature to dynamically add CSS to the page if the HTML content requires it.

func SECTION

func SECTION(class string, content ...interface{}) View

SECTION creates <sections class="class">content</section>

func STRONG

func STRONG(content ...interface{}) View

STRONG creates <strong>content</strong>

func UncacheView

func UncacheView(cachedView *CachedView) View

UncacheView removes the CachedView from the internal list CachedViews that is used by ClearAllCaches(). It returnes the View wrapped CachedView.

func ViewOrError

func ViewOrError(view View, err error) View

ViewOrError returns view if err is nil, or else an Error view for err.

func WrapContents

func WrapContents(contents ...interface{}) View

WrapContents encapsulates multiple content arguments as View by calling NewView() for every one of them. It is more efficient for one view because the view is passed through instead of wrapped with a Views slice like NewViews does.

type ViewBase

type ViewBase struct {
	// contains filtered or unexported fields
}

ViewBase is a base for View implementations.

func (*ViewBase) ID

func (self *ViewBase) ID() string

func (*ViewBase) Init

func (self *ViewBase) Init(thisView View)

func (*ViewBase) IterateChildren

func (self *ViewBase) IterateChildren(callback IterateChildrenCallback)

type ViewBaseWithId

type ViewBaseWithId struct {
	ViewBase
	// contains filtered or unexported fields
}

ViewBaseWithId extends ViewBase with an id for the view.

func (*ViewBaseWithId) ID

func (self *ViewBaseWithId) ID() string

func (*ViewBaseWithId) Init

func (self *ViewBaseWithId) Init(thisView View)

type ViewPath

type ViewPath struct {
	Name   string
	Args   int
	View   View
	Auth   Authenticator
	NoAuth URL
	Sub    []ViewPath // Only allowed when View is a Page or nil
}

ViewPath holds all data necessary to define the URL path of a view, including the number of arguments parsed from the URL path, an Authenticator and sub paths.

type ViewURLWrapper

type ViewURLWrapper struct {
	View View
	// contains filtered or unexported fields
}

func NewViewURLWrapper

func NewViewURLWrapper(view View) *ViewURLWrapper

func (*ViewURLWrapper) ID

func (self *ViewURLWrapper) ID() string

func (*ViewURLWrapper) Init

func (self *ViewURLWrapper) Init(thisView View)

func (*ViewURLWrapper) IterateChildren

func (self *ViewURLWrapper) IterateChildren(callback IterateChildrenCallback)

func (*ViewURLWrapper) Render

func (self *ViewURLWrapper) Render(ctx *Context) (err error)

func (*ViewURLWrapper) SetPath

func (self *ViewURLWrapper) SetPath(path string)

func (*ViewURLWrapper) URL

func (self *ViewURLWrapper) URL(ctx *Context) string

type ViewWithURL

type ViewWithURL interface {
	View
	URL
	SetPath(path string)
}

ViewWithURL combines the View interface with the URL interface for views that have an URL

func DynamicViewWithURL

func DynamicViewWithURL(getViewFunc func(*Context) (View, error)) ViewWithURL

DynamicViewWithURL returns a ViewWithURL for getViewFunc.

func DynamicViewWithURLBindURLArgs

func DynamicViewWithURLBindURLArgs(getViewFunc interface{}) ViewWithURL

DynamicViewWithURLBindURLArgs returns a ViewWithURL for getViewFunc. For an explanation of getViewFunc see DynamicViewBindURLArgs().

func HTML5BoilerplateCSS

func HTML5BoilerplateCSS(staticCssFilenames ...string) ViewWithURL

HTML5BoilerplateCSS returns a ViewWithURL that concatenates static files with HTML5 Boilerplate CSS normalization.

Example:

myCSS := HTML5BoilerplateCSS("common.css", "special.css")
page := &Page{
	CSS: myCSS,
}

func IndirectViewWithURL

func IndirectViewWithURL(viewWithURL *ViewWithURL) ViewWithURL

func NewHTML5BoilerplateCSSTemplate

func NewHTML5BoilerplateCSSTemplate(getContext GetTemplateContextFunc, filenames ...string) ViewWithURL

NewHTML5BoilerplateCSSTemplate returns a ViewWithURL that concatenates text templates with HTML5 Boilerplate CSS normalization.

func RenderViewWithURL

func RenderViewWithURL(renderFunc func(*Context) error) ViewWithURL

RenderViewWithURL returns a ViewWithURL for renderFunc.

func RenderViewWithURLBindURLArgs

func RenderViewWithURLBindURLArgs(renderFunc interface{}) ViewWithURL

RenderViewWithURLBindURLArgs returns a ViewWithURL for renderFunc. For an explanation of renderFunc see RenderViewBindURLArgs().

type ViewWithURLBase

type ViewWithURLBase struct {
	ViewBase
	// contains filtered or unexported fields
}

func (*ViewWithURLBase) SetPath

func (self *ViewWithURLBase) SetPath(path string)

func (*ViewWithURLBase) URL

func (self *ViewWithURLBase) URL(ctx *Context) string

type Views

type Views []View

Views implements the View interface for a slice of views. The views of the slice are the child views.

func AddStandardLabel

func AddStandardLabel(form *Form, forView View, metaData *model.MetaData) Views

func LABEL

func LABEL(label interface{}, target View) Views

LABEL creates a Label for target and returns it together with target.

func NewViews

func NewViews(contents ...interface{}) Views

NewViews encapsulates multiple content arguments as views by calling NewView() for every one of them.

func (Views) ID

func (self Views) ID() string

func (Views) Init

func (self Views) Init(thisView View)

func (Views) IterateChildren

func (self Views) IterateChildren(callback IterateChildrenCallback)

Does not iterate nil children

func (Views) Render

func (self Views) Render(ctx *Context) (err error)

type ViewsListModel

type ViewsListModel []View

func (ViewsListModel) ItemView

func (self ViewsListModel) ItemView(index int, ctx *Context) (view View, err error)

func (ViewsListModel) NumItems

func (self ViewsListModel) NumItems() int

type ViewsTableModel

type ViewsTableModel []Views

func (ViewsTableModel) CellView

func (self ViewsTableModel) CellView(row int, column int, ctx *Context) (view View, err error)

func (ViewsTableModel) Columns

func (self ViewsTableModel) Columns() int

func (ViewsTableModel) Rows

func (self ViewsTableModel) Rows() int

Jump to

Keyboard shortcuts

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