plus/minus/times/divide

text

{{.value | text}}

Removes HTML tags from the value variable and displays only the text content (and removes script tags). Example:

{{"<div>Test</div>"|text}}
// Output: Test

htmlencode/encode/html

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

Escapes the value variable with HTML encoding. Example:

{{"<div>Test</div>"|html}}
// Output: &lt;div&gt;Test&lt;/div&gt;

htmldecode/decode

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

Decodes the HTML encoded value variable. Example:

{{"<div>Test</div>" | htmldecode}}
// Output: <div>Test</div>

urlencode/url

{{.url | url}}

Escapes the url variable in URL encoding. Example:

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

urldecode

{{.url | urldecode}}

Decodes the URL encoded url variable. Example:

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

date

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

Formats the timestamp variable into a date and time, similar to PHP’s date method. The format parameter supports PHP date format. Additionally, refer to Time.

When timestamp is null (or 0), the current time is used as the timestamp parameter.

Example:

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

compare

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

Compares the strings str1 and str2. Return values: - 0 : str1 == str2 - 1 : str1 > str2 - -1 : str1 < str2

Example:

{{compare "A" "B"}}
{{compare "1" "2"}}
{{compare 2 1}}
{{compare 1 1}}
// Output:
// -1
// -1
// 1
// 0

replace

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

Replaces search with replace in str. Example:

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

substr

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

Extracts a substring from str starting at index start (index starts from 0) for length characters, supporting Chinese characters, similar to PHP’s substr function. Example:

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

strlimit

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

Limits the str string to length characters, supporting Chinese characters, and appends the suffix string if it exceeds the length. Example:

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

concat

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

Concatenates strings. Example:

{{concat "我" "是" "中" "国" "人"}}
// Output:
// 我是中国人

hidestr

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

Hides characters in str according to a percent percentage, hiding towards the center of the string using the hide variable, commonly used for names, phone numbers, email addresses, and ID numbers. It supports Chinese characters and email formats. Example:

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

highlight

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

Highlights the keyword key in str with the specified color color. Example:

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

toupper/tolower

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

Converts the case of str. Example:

{{"gf" | toupper}}
{{"GF" | tolower}}
// Output:
// GF
// gf

nl2br

{{.str | nl2br}}

Replaces \n/\r in str with HTML <br /> tags. Example:

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

dump

{{dump .var}}

Formats and prints the variable, similar to the g.Dump function, often used for development and debugging. Example:

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

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

map

{{map .var}}

Converts a template variable to map[string]interface{} type, commonly used for range...end iteration.

maps

{{maps .var}}

Converts a template variable to []map[string]interface{} type, commonly used for range...end iteration.

json/xml/ini/yaml/yamli/toml