添加链接
link管理
链接快照平台
  • 输入网页链接,自动生成快照
  • 标签化管理网页链接

plus/minus/times/divide

函数 说明 格式 示例 备注
plus {{.value1 | plus .value2}} {{2 | plus 3}} => 5 3+2
minus {{.value1 | minus .value2}} {{2 | minus 3}} => 1 3-2
times {{.value1 | times .value2}} {{2 | times 3}} => 6 3*2
divide {{.value1 | divide .value2}} {{2 | divide 3}} => 1.5 3/2

text

{{.value | text}}

value 变量值去掉HTML标签,仅显示文字内容(并且去掉 script 标签)。 示例:

{{"<div>测试</div>"|text}}
// 输出: 测试

htmlencode/encode/html

{{.value | htmlencode}}
{{.value | encode}}
{{.value | html}}

value 变量值进行html转义。 示例:

{{"<div>测试</div>"|html}}
// 输出: &lt;div&gt;测试&lt;/div&gt;

htmldecode/decode

{{.value | htmldecode}}
{{.value | decode}}

value 变量值进行html反转义。 示例:

{{"&lt;div&gt;测试&lt;/div&gt;" | htmldecode}}
// 输出: <div>测试</div>

urlencode/url

{{.url | url}}

url 变量值进行 url 转义。 示例:

{{"https://goframe.org" | url}}
// 输出: https%3A%2F%2Fgoframe.org

urldecode

{{.url | urldecode}}

url 变量值进行 url 反转义。 示例:

{{"https%3A%2F%2Fgoframe.org"|urldecode}}
// 输出: https://goframe.org
{{.timestamp | date .format}}
{{date .format .timestamp}}
{{date .format}}

timestamp 时间戳变量进行时间日期格式化,类似PHP的 date 方法, format 参数支持 PHP date 方法格式,亦可参考 时间管理-gtime

timestamp 变量为 (或者 0 )时,表示以当前时间作为时间戳参数执行打印。

示例:

{{1540822968 | date "Y-m-d"}}
{{"1540822968" | date "Y-m-d H:i:s"}}
{{date "Y-m-d H:i:s"}}
// 输出:
// 2018-10-29
// 2018-10-29 22:22:48
// 2018-12-05 10:22:00

compare

{{compare .str1 .str2}}
{{.str2 | compare .str1}}

str1 str2 进行字符串比较,返回值: - 0 : str1 == str2 - 1 : str1 > str2 - -1 : str1 < str2

示例:

{{compare "A" "B"}}
{{compare "1" "2"}}
{{compare 2 1}}
{{compare 1 1}}
// 输出:
// -1
// -1

replace

{{.str | replace .search .replace}}
{{replace .search .replace .str}}

str 中的 search 替换为 replace 。 示例:

{{"I'm中国人" | replace "I'm" "我是"}}
// 输出:
// 我是中国人

substr

{{.str | substr .start .length}}
{{substr .start .length .str}}

str start 索引位置(索引从0开始)进行字符串截取 length ,支持中文,类似PHP的 substr 函数。 示例:

{{"我是中国人" | substr 2 -1}}
{{"我是中国人" | substr 2  2}}
// 输出:
// 中国人
// 中国

strlimit

{{.str | strlimit .length .suffix}}

str 字符串截取 length 长度,支持中文,超过长度则追加 suffix 字符串到末尾。 示例:

{{"我是中国人" | strlimit 2  "..."}}
// 输出:
// 我是...

concat

{{concat .str1 .str2 .str3...}}

拼接字符串。 示例:

{{concat "我" "是" "中" "国" "人"}}
// 输出:
// 我是中国人

hidestr

{{.str | hidestr .percent .hide}}

str 字符串按照 percent 百分比从字符串中间向两边隐藏字符(主要用于姓名、手机号、邮箱地址、身份证号等的隐藏),隐藏字符由 hide 变量定义。 支持中文,支持email格式。 示例:

{{"热爱GF热爱生活" | hidestr 20  "*"}}
{{"热爱GF热爱生活" | hidestr 50  "*"}}
// 输出:
// 热爱GF*爱生活
// 热爱****生活

highlight

{{.str | highlight .key .color}}

str 字符串中的关键字 key 按照定义的颜色 color 进行前置颜色高亮。 示例:

{{"热爱GF热爱生活" | highlight "GF" "red"}}
// 输出:
// 热爱<span style="color:red;">GF</span>热爱生活

toupper/tolower

{{.str | toupper}}
{{.str | tolower}}

str 字符串进行大小写转换。 示例:

{{"gf" | toupper}}
{{"GF" | tolower}}
// 输出:
// GF
// gf

nl2br

{{.str | nl2br}}

str 字符串中的 \n/\r 替换为html中的 <br /> 标签。 示例:

{{"Go\nFrame" | nl2br}}
// 输出:
// Go<br />Frame
{{dump .var}}

格式化打印变量,功能类似于 g.Dump 方法,常用于开发调试。 示例:

gview.Assign("var", g.Map{
    "name" : "john",
{{dump .var}}
// 输出:
// <!--
//     name: "john"
// -->
{{map .var}}

将模板变量转换为 map[string]interface{} 类型,常用于 range...end 遍历。

maps

{{maps .var}}

将模板变量转换为 []map[string]interface{} 类型,常用于 range...end 遍历。

json/xml/ini/yaml/yamli/toml

函数 说明 格式
json 将模板变量转换为 JSON 格式字符串。 {{json .var}}
xml 将模板变量转换为 XML 格式字符串。 {{xml .var}}
ini 将模板变量转换为 INI 格式字符串。 {{ini .var}}
yaml 将模板变量转换为 YAML 格式字符串。 {{yaml .var}}
yamli 将模板变量转换为带有自定义缩进的 YAML 格式字符串。 {{yamli .var .indent}}
toml 将模板变量转换为 TOML 格式字符串。 {{toml .var}}
Content Menu

框架`substr`目前绑定的实现是`SubStrRune`

// buildInFuncSubStr implements build-in template function: substr
func (view *View) buildInFuncSubStr(start, end, str interface{}) string {
	return gstr.SubStrRune(gconv.String(str), gconv.Int(start), gconv.Int(end))

在测试用例中:

 func Test_SubStrRune(t *testing.T) {
	gtest.C(t, func(t *gtest.T) {
		t.Assert(gstr.SubStrRune("我爱GoFrame", 0), "我爱GoFrame")
		t.Assert(gstr.SubStrRune("我爱GoFrame", 2), "GoFrame")
		t.Assert(gstr.SubStrRune("我爱GoFrame", 2, 2), "Go")
		t.Assert(gstr.SubStrRune("我爱GoFrame", -1, 30), "e")
		t.Assert(gstr.SubStrRune("我爱GoFrame", 30, 30), "")
		t.Assert(gstr.SubStrRune("abcdef", 0, -1), "abcde")
		t.Assert(gstr.SubStrRune("abcdef", 2, -1), "cde")
		t.Assert(gstr.SubStrRune("abcdef", 4, -4), "")
		t.Assert(gstr.SubStrRune("abcdef", -3, -1), "de")
		t.Assert(gstr.SubStrRune("我爱GoFrame呵呵", -3, 100), "e呵呵")
		t.Assert(gstr.SubStrRune("abcdef哈哈", -3, -1), "f哈")
		t.Assert(gstr.SubStrRune("ab我爱GoFramecdef哈哈", -3, -1), "f哈")
		t.Assert(gstr.SubStrRune("我爱GoFrame", 0, 3), "我爱G")


而文档这边示例中第一个`substr`中`end`要使用`-1`来表示直至`string`末尾的话,与实际的代码逻辑与测试用例不符合,输出是有问题的:

{{"我是中国人" | substr 2 -1}}   <----------------- 这里 
{{"我是中国人" | substr 2  2}}
// 输出:
// 中国人
// 中国

测试用例中:

 t.Assert(gstr.SubStrRune("abcdef", 2, -1), "cde")


另外实际上`method signature`实现上`length`可以留空,然而在模板使用的时候似乎没有留出这点,

func SubStrRune(str string, start int, length ...int) (substr string) {

所以如果字符串要截取到最后目前可以使用

{{substr 2 ("abcdefg"|len) "abcdefg"}}

这里不用考虑多字符`rune`问题,因为`SubStrRune`实现中如果超过字符串长度会自动替换为至实际长度

  • May 08, 2023
  •