template

Documentation

Index

• Constants
• Variables
• func Add(name string, temp Template)
• func AddComp(comp Component)
• func AddFromPlugin(name string, mod string)
• func AddLoginComp(comp Component)
• func CSS(s string) template.CSS
• func CheckRequirements() (bool, bool)
• func CheckThemeRequirements() bool
• func Execute(param ExecuteParam) *bytes.Buffer
• func GetAsset(path string) ([]byte, error)
• func GetComponentAsset() []string
• func GetComponentAssetImportHTML() (res template.HTML)
• func GetComponentAssetWithinPage() []string
• func GetPageContentFromPageType(title, desc, msg string, pt PageType) (template.HTML, template.HTML, template.HTML)
• func HTML(s string) template.HTML
• func JS(s string) template.JS
• func SetComp(name string, comp Component)
• func Themes() []string
• func VersionCompare(toCompare string, versions []string) bool
• func WarningPanel(msg string, pts ...PageType) types.Panel
• type BaseComponent
  • func (b BaseComponent) GetAsset(name string) ([]byte, error)
  • func (b BaseComponent) GetAssetList() []string
• type Component
  • func GetComp(name string) Component
• type ExecuteParam
• type PageType
• type Template
  • func Default() Template
  • func Get(theme string) Template

Constants

const (
	CompCol       = "col"
	CompRow       = "row"
	CompForm      = "form"
	CompTable     = "table"
	CompDataTable = "datatable"
	CompTree      = "tree"
	CompTreeView  = "treeview"
	CompTabs      = "tabs"
	CompAlert     = "alert"
	CompLink      = "link"
	CompPaginator = "paginator"
	CompPopup     = "popup"
	CompBox       = "box"
	CompLabel     = "label"
	CompImage     = "image"
	CompButton    = "button"
)

Variables

var DefaultFuncMap = template.FuncMap{
	"lang":     language.Get,
	"langHtml": language.GetFromHtml,
	"link": func(cdnUrl, prefixUrl, assetsUrl string) string {
		if cdnUrl == "" {
			return prefixUrl + assetsUrl
		}
		return cdnUrl + assetsUrl
	},
	"isLinkUrl": func(s string) bool {
		return (len(s) > 7 && s[:7] == "http://") || (len(s) > 8 && s[:8] == "https://")
	},
	"render": func(s, old, repl template.HTML) template.HTML {
		return template.HTML(strings.Replace(string(s), string(old), string(repl), -1))
	},
	"renderJS": func(s template.JS, old, repl template.HTML) template.JS {
		return template.JS(strings.Replace(string(s), string(old), string(repl), -1))
	},
	"divide": func(a, b int) int {
		return a / b
	},
	"renderRowDataHTML": func(id, content template.HTML, value ...map[string]types.InfoItem) template.HTML {
		return template.HTML(types.ParseTableDataTmplWithID(id, string(content), value...))
	},
	"renderRowDataJS": func(id template.HTML, content template.JS, value ...map[string]types.InfoItem) template.JS {
		return template.JS(types.ParseTableDataTmplWithID(id, string(content), value...))
	},
	"attr": func(s template.HTML) template.HTMLAttr {
		return template.HTMLAttr(s)
	},
	"js": func(s interface{}) template.JS {
		if ss, ok := s.(string); ok {
			return template.JS(ss)
		}
		if ss, ok := s.(template.HTML); ok {
			return template.JS(ss)
		}
		return ""
	},
	"changeValue": func(f types.FormField, index int) types.FormField {
		if len(f.ValueArr) > 0 {
			f.Value = template.HTML(f.ValueArr[index])
		}
		if len(f.OptionsArr) > 0 {
			f.Options = f.OptionsArr[index]
		}
		if f.FormType.IsSelect() {
			f.FieldClass += "_" + strconv.Itoa(index)
		}
		return f
	},
}

var DefaultThemeNames = []string{"sword", "adminlte"}

Functions

func Add

func Add(name string, temp Template)

Add makes a template available by the provided theme name. If Add is called twice with the same name or if template is nil, it panics.

func AddComp

func AddComp(comp Component)

AddComp makes a component available by the provided name. If Add is called twice with the same name or if component is nil, it panics.

func AddFromPlugin

func AddFromPlugin(name string, mod string)

func AddLoginComp

func AddLoginComp(comp Component)

AddLoginComp add the specified login component.

func CSS

func CSS(s string) template.CSS

func CheckRequirements

func CheckRequirements() (bool, bool)

func CheckThemeRequirements

func CheckThemeRequirements() bool

func Execute

func Execute(param ExecuteParam) *bytes.Buffer

func GetAsset

func GetAsset(path string) ([]byte, error)

func GetComponentAsset

func GetComponentAsset() []string

func GetComponentAssetImportHTML

func GetComponentAssetImportHTML() (res template.HTML)

func GetComponentAssetWithinPage

func GetComponentAssetWithinPage() []string

func GetPageContentFromPageType

func GetPageContentFromPageType(title, desc, msg string, pt PageType) (template.HTML, template.HTML, template.HTML)

func HTML

func HTML(s string) template.HTML

func JS

func JS(s string) template.JS

func SetComp

func SetComp(name string, comp Component)

SetComp makes a component available by the provided name. If the value corresponding to the key is empty or if component is nil, it panics.

func Themes

func Themes() []string

func VersionCompare

func VersionCompare(toCompare string, versions []string) bool

func WarningPanel

func WarningPanel(msg string, pts ...PageType) types.Panel

Types

type BaseComponent

type BaseComponent struct{}

func (BaseComponent) GetAsset

func (b BaseComponent) GetAsset(name string) ([]byte, error)

func (BaseComponent) GetAssetList

func (b BaseComponent) GetAssetList() []string

type Component

type Component interface {
	// GetTemplate return a *template.Template and a given key.
	GetTemplate() (*template.Template, string)

	// GetAssetList return the assets url suffix used in the component.
	// example:
	//
	// {{.UrlPrefix}}/assets/login/css/bootstrap.min.css => login/css/bootstrap.min.css
	//
	// See:
	// https://github.com/GoAdminGroup/go-admin/blob/master/template/login/theme1.tmpl#L32
	// https://github.com/GoAdminGroup/go-admin/blob/master/template/login/list.go
	GetAssetList() []string

	// GetAsset return the asset content according to the corresponding url suffix.
	// Asset content is recommended to use the tool go-bindata to generate.
	//
	// See: http://github.com/jteeuwen/go-bindata
	GetAsset(string) ([]byte, error)

	GetContent() template.HTML

	IsAPage() bool

	GetName() string
}

Component is the interface which stand for a ui component.

func GetComp

func GetComp(name string) Component

GetComp gets the component by registered name. If the name is not found, it panics.

type ExecuteParam

type ExecuteParam struct {
	User       models.UserModel
	Tmpl       *template.Template
	TmplName   string
	Panel      types.Panel
	Config     c.Config
	Menu       *menu.Menu
	Animation  bool
	Buttons    types.Buttons
	NoCompress bool
	Iframe     bool
}

type PageType

type PageType uint8

const (
	NormalPage PageType = iota
	Missing404Page
	Error500Page
	NoPermission403Page
)

type Template

type Template interface {
	Name() string

	// layout
	Col() types.ColAttribute
	Row() types.RowAttribute

	// form and table
	Form() types.FormAttribute
	Table() types.TableAttribute
	DataTable() types.DataTableAttribute

	TreeView() types.TreeViewAttribute
	Tree() types.TreeAttribute
	Tabs() types.TabsAttribute
	Alert() types.AlertAttribute
	Link() types.LinkAttribute

	Paginator() types.PaginatorAttribute
	Popup() types.PopupAttribute
	Box() types.BoxAttribute

	Label() types.LabelAttribute
	Image() types.ImgAttribute

	Button() types.ButtonAttribute

	// Builder methods
	GetTmplList() map[string]string
	GetAssetList() []string
	GetAssetImportHTML(exceptComponents ...string) template.HTML
	GetAsset(string) ([]byte, error)
	GetTemplate(bool) (*template.Template, string)
	GetVersion() string
	GetRequirements() []string
	GetHeadHTML() template.HTML
	GetFootJS() template.HTML
	Get404HTML() template.HTML
	Get500HTML() template.HTML
	Get403HTML() template.HTML
}

Template is the interface which contains methods of ui components. It will be used in the plugins for custom the ui.

func Default

func Default() Template

Default get the default template with the theme name set with the global config. If the name is not found, it panics.

func Get

func Get(theme string) Template

Get the template interface by theme name. If the name is not found, it panics.