html

Documentation

Overview

Package html 提供输出 HTML 内容的 encoding.MarshalFunc 函数。

tpl := template.ParseFiles(...)
mgr := html.New(tpl)
encoding.AddMarshal("text/html", mgr.Marshal)

func handle(w http.ResponseWriter, r *http.Request) {
    ctx := web.New(w, r)
    ctx.Render(html.Tpl("index", map[string]interface{}{...}))
}

Index

• Constants
• type HTML
  • func New(tpl *template.Template) *HTML
  • func (html *HTML) Marshal(v interface{}) ([]byte, error)
  • func (html *HTML) SetTemplate(tpl *template.Template)
• type Template
  • func Tpl(name string, data interface{}) *Template

Constants

const MimeType = "text/html"

MimeType HTML 的 mimetype 值

Types

type HTML

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

HTML 模板管理

func New

func New(tpl *template.Template) *HTML

New 声明 HTML 变量

tpl 可以为空，通过之后的 SetTemplate 再次指定

func (*HTML) Marshal

func (html *HTML) Marshal(v interface{}) ([]byte, error)

Marshal 针对 HTML 内容的 MarshalFunc 实现

func (*HTML) SetTemplate

func (html *HTML) SetTemplate(tpl *template.Template)

SetTemplate 修改模板内容

type Template

type Template struct {
	Name string // 模块名称
	Data interface{}
}

Template 传递给 encoding.MarshalFunc 的参数。

因为 encoding.MarshalFunc 限定了只能有一个参数， 而模板解析，除了传递的值，最起码还要一个模板名称， 所以采用 Template 作了一个简单的包装。

func Tpl

func Tpl(name string, data interface{}) *Template

Tpl 声明一个 *Template 变量。

其中 name 表示需要引用的模板名称， 而 data 则是传递给该模板的所有变量。

实际上就是

&Template {
  Name: name,
  Data: data,
}

的简单写法。