模板

模板中的变量和函数

模板中可以使用的函数或者变量来源如下：

  1. 1）Go模板自带的模板函数
  2. 2）xweb内置的模板函数和变量
  3. 3）通过Server.AddTmplVar或者AddTmplVars添加的函数或者变量
  4. 4）通过App.AddTmplVar或者AddTmplVars添加的函数或者变量
  5. 5）通过Action.AddTmplVar或者AddTmplVars添加的函数或者变量
  6. 6）Action的公共变量和公共方法

Go模板自带模板函数

这个请参见 https://gowalker.org/text/template

xweb内置的模板函数和变量

xweb内置的模板函数和Go模板函数一样，在模板中使用{{funcName …}}形式调用。内置的变量使用{{.T.}}方式调用。

  • IsNil(a interface{}) bool
    判断一个指针是否为空

  • Add(left interface{}, right interface{}) interface{}
    整数或浮点数加法

  • Subtract(left interface{}, right interface{}) interface{}
    整数或者浮点数减法

  • Now()
    当前时间

  • UrlFor(args ...string) string
    返回一个route对应的url

  • FormatDate(t time.Time, format string) string
    日期格式化，格式方法和Go的格式方法相同

  • Eq(left interface{}, right interface{}) bool
    相等判断，go1.2以上请使用Go自带的eq

  • Html(raw string) template.HTML
    以html格式输出

  • Js(raw string) template.JS
    输出javascript代码

  • StaticUrl(url string) string
    自动为静态文件添加版本标识

  • XsrfName() string
    返回xsrf的cookie名称

  • XsrfFormHtml() template.HTML
    在表单中生成防xsrf的隐藏表单

  • XsrfValue() string
    自动生成的防xsrf随机值

  • session(key string) interface{}
    获取session的值

  • cookie(key string) interface{}
    获取cookie的指

通过xweb.AddTmplVar或者AddTmplVars添加的函数或者变量

通过xweb.AddTmplVar或者AddTmplVars添加的函数或者变量在MainServer的RootApp范围内有效，在模板中使用{{funcName …}}形式调用函数。变量使用{{.T.}}方式调用。

通过App.AddTmplVar或者AddTmplVars添加的函数或者变量

通过App.AddTmplVar或者AddTmplVars添加的函数或者变量在此App范围内有效，在模板中使用{{funcName …}}形式调用函数。变量使用{{.T.}}方式调用。

通过Action.AddTmplVar或者AddTmplVars添加的函数或者变量

通过Action.AddTmplVar或者AddTmplVars添加的函数或者变量在此Action范围内有效，在模板中使用{{funcName …}}形式调用函数。变量使用{{.T.}}方式调用。

Action的公共变量和公共方法

Action的公共变量，通过{{.xxx}}的方式调用，公共方法通过{{.xxx}}的方式调用

模板包含

xweb使用include函数来进行模板包含，而不使用template函数。

  • include(tmpl string) interface{}
    包含另外一个模版

包含方式如下：

  1. {{include "head.tmpl"}}

在包含时，只有一个模板名参数，此时head.html模板中的变量和函数也自动由当前Action传入。