GoFrame 模板函數(shù)-內(nèi)置函數(shù)

plus/minus/times/divide

text

{{.value | text}}

將?value?變量值去掉?HTML?標(biāo)簽，僅顯示文字內(nèi)容（并且去掉?script?標(biāo)簽）。 示例：

{{"<div>測試</div>"|text}}
// 輸出: 測試

htmlencode/encode/html

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

將?value?變量值進行?html?轉(zhuǎn)義。 示例：

{{"<div>測試</div>"|html}}
// 輸出: &lt;div&gt;測試&lt;/div&gt;

htmldecode/decode

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

將?value?變量值進行?html?反轉(zhuǎn)義。 示例：

{{"<div>測試</div>" | htmldecode}}
// 輸出: <div>測試</div>

urlencode/url

{{.url | url}}

將?url?變量值進行?url?轉(zhuǎn)義。 示例：

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

urldecode

{{.url | urldecode}}

將?url?變量值進行?url?反轉(zhuǎn)義。 示例：

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

date

{{.timestamp | date .format}}
{{date .format .timestamp}}
{{date .format}}

將?timestamp?時間戳變量進行時間日期格式化，類似PHP的?date?方法，?format?參數(shù)支持 PHP date 方法格式。

當(dāng)?timestamp?變量為空(或者?0?)時，表示以當(dāng)前時間作為時間戳參數(shù)執(zhí)行打印。

示例：

{{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
// 1
// 0

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?函數(shù)。 示例：

{{"我是中國人" | 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?字符串中的關(guān)鍵字?key?按照定義的顏色?color?進行前置顏色高亮。 示例：

{{"熱愛GF熱愛生活" | highlight "GF" "red"}}
// 輸出:
// 熱愛<span style="color:red;">GF</span>熱愛生活

toupper/tolower

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

將?str?字符串進行大小寫轉(zhuǎn)換。 示例：

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

nl2br

{{.str | nl2br}}

將?str?字符串中的?\n/\r?替換為html中的?<br />?標(biāo)簽。 示例：

{{"Go\nFrame" | nl2br}}
// 輸出:
// Go<br />Frame

dump

{{dump .var}}

格式化打印變量，功能類似于?g.Dump?方法，常用于開發(fā)調(diào)試。 示例：

gview.Assign("var", g.Map{
    "name" : "john",
})

{{dump .var}}
// 輸出:
// <!--
// {
//     name: "john"
// }
// -->

map

{{map .var}}

將模板變量轉(zhuǎn)換為?map[string]interface{}?類型，常用于?range...end?遍歷。

maps

{{maps .var}}

將模板變量轉(zhuǎn)換為?[]map[string]interface{}?類型，常用于?range...end?遍歷。

json/xml/ini/yaml/yamli/toml