Smarty模板語(yǔ)法詳解

更新時(shí)間：2019年07月20日 07:23:45 作者：Sams-ara

這篇文章主要介紹了Smarty模板語(yǔ)法,結(jié)合實(shí)例形式詳細(xì)分析了Smarty模板的注釋、變量、引號(hào)、函數(shù)等基本語(yǔ)法與使用技巧,需要的朋友可以參考下

本文實(shí)例講述了Smarty模板語(yǔ)法。分享給大家供大家參考，具體如下：

所有模版標(biāo)簽用分隔符包圍，默認(rèn)為“{”和“}”。

模板注釋

模板注釋被星號(hào)包圍，兩邊星號(hào)被定界符“{ }”包圍，如 { smarty * }

smarty注釋不會(huì)在模板文件的最后輸出中出現(xiàn)，這與不同（譯注：html注釋在頁(yè)面源碼中可見(jiàn)，而smarty注釋則不能）。

如下簡(jiǎn)單代碼片{smarty}在源碼中不可見(jiàn)，而源碼可見(jiàn)。

<html>
<head>
<tltle>smarty</tltle>
<body>
{*smarty*}
smarty
<!--smarty-->
</body>
</head>
</html>

變量初步

模板變量用美元符號(hào)開(kāi)始，可以包含數(shù)字、字母和下劃線，這php很像。（注意：配置文件變量是一個(gè)不用美元符號(hào)開(kāi)始，可以包含數(shù)字、字母和下劃線，這php很像。（注意：配置文件變量是一個(gè)不用美元符號(hào)，而是用#號(hào)包圍著變量（#hashmarks#），或者是一個(gè)$smarty.config形式的變量。）

這里config不做說(shuō)明，下面是變量示例：

{$a+$b}      //最簡(jiǎn)單的變量處理方法
{$a={$b}+1}   //標(biāo)簽嵌套標(biāo)簽
{$array[$a]}  //變量做數(shù)組索引
{$assign var=fun value=$a+$b}  //變量賦值
{$fun="{a}"}  //引號(hào)套用標(biāo)簽
{$assign var=fun value=[1,2,3]}
{$assign var=fun value=[1,2,[3,4]]}
{$assign var=fun value=[1=>'one',2=>'tow']}    //數(shù)組定義
{$fun=stlen($a)}
{fun=function($a,$b)}     //用作函數(shù)參數(shù)
{$array.a=1}
{$array.a.b.c($array[a][b][c])=1}  //數(shù)組索引賦值
{$object->method1($x)->method2($y)}   //對(duì)象鏈

雙引號(hào)中插入變量

1、Smarty可以識(shí)別嵌入在雙引號(hào)中的變量，只要此變量只包含數(shù)字、字母、下劃線和中括號(hào)[]。
2、對(duì)于句號(hào)，數(shù)組和對(duì)象引用等的符號(hào)此變量必須用兩個(gè)反引號(hào)`。
3、Smarty3增加了雙引號(hào)對(duì)Smarty標(biāo)簽的支持。在需要包含調(diào)節(jié)器變量、插件、php函數(shù)返回值的情形中非常實(shí)用。

{function var="test $foo test"}       // 識(shí)別 $foo
{func var="test $foo_bar test"}       // 識(shí)別 $foo_bar
{func var="test `$foo[0]` test"}     // 識(shí)別 $foo[0]
{func var="test `$foo[bar]` test"}   // 識(shí)別 $foo[bar]
{func var="test $foo.bar test"}       // 識(shí)別  $foo (無(wú)法識(shí)別 $foo.bar)
{func var="test `$foo.bar` test"}    // 識(shí)別 $foo.bar
{func var="test `$foo.bar` test"|escape} //調(diào)節(jié)器在引號(hào)外
{func var="test {$foo|escape} test"}   // 調(diào)節(jié)器在引號(hào)內(nèi)
{func var="test {time()} test"}        // PHP 函數(shù)識(shí)別
{func var="test {counter} test"}      //標(biāo)簽識(shí)別

函數(shù)

每一個(gè)smarty標(biāo)簽輸出一個(gè)變量或者調(diào)用某種函數(shù)。在定界符內(nèi)函數(shù)（一般定界符‘{}'包住）和其屬性（同樣在定界符內(nèi)）將被處理和輸出。例如: {function（函數(shù)名） attr1（變量名）=”val”（變量值） attr2=”val”}.

{config_load file="colors.conf"}
{include file="header.tpl"}
{if $highlight_name}
  Welcome, <font color="{#fontColor#}">{$name}!</font>
{else}
  Welcome, {$name}!
{/if}
{include file="footer.tpl"}

1、在模板里無(wú)論是內(nèi)置函數(shù)還是自定義函數(shù)都有相同的語(yǔ)法。
2、內(nèi)置函數(shù)將在smarty內(nèi)部工作,例如{if}、{section}和{strip}，不能修改他們。
3、自定義函數(shù)通過(guò)插件機(jī)制起作用，它們是附加函數(shù)。只要你喜歡，可以隨意修改，你也可以自行添加。例如{html_options}和{html_select_date}。

屬性

大多數(shù)函數(shù)都帶有自己的屬性以便于明確說(shuō)明或者修改他們的行為，smarty函數(shù)的屬性很像HTML中的屬性。靜態(tài)數(shù)值不需要加引號(hào)，但是字符串建議使用引號(hào)。可以使用普通smarty變量，也可以使用帶調(diào)節(jié)器的變量作為屬性值，它們也不用加引號(hào)。你甚至可以使用php函數(shù)返回值和復(fù)雜表達(dá)式作為屬性值。

Math

數(shù)學(xué)運(yùn)算可以直接作用到變量值。

{$foo+1}
{$foo*$bar}
{$foo|truncate:"`$fooTruncCount/$barTruncFactor-1`"}
{assign var="foo" value="`$foo+$bar`"}

忽略smarty語(yǔ)法

忽略Smarty對(duì)某些語(yǔ)句段的解析很有必要。一種典型的情況是嵌入到模板中的javascript或Css代碼。原因在于這些語(yǔ)言使用與Smarty默認(rèn)定界符‘｛'和‘｝'一樣的符號(hào)。

方法：一個(gè)避免出現(xiàn)這種情況的好習(xí)慣是把你的javascript/css代碼分離出來(lái)保存成一個(gè)獨(dú)立文件，再用html方法鏈接到模版中。這樣做也有利于瀏覽器緩存腳本。如果你想把Smarty變量、方法嵌入到j(luò)avascript/css，請(qǐng)看下面的運(yùn)用。

在Smarty模版，如果‘｛'和‘｝'大括號(hào)里包含有空格那么整個(gè){}內(nèi)容會(huì)被忽略，你可以設(shè)置Smarty類變量$auto_literal=false來(lái)取消這種規(guī)則。

<script>
// the following braces are ignored by Smarty 以下大括號(hào)的內(nèi)容會(huì)被Smarty忽略
// since they are surrounded by whitespace 因?yàn)樗鼈兝锩嬗锌崭?
function foobar {
alert('foobar!');
}
// this one will need literal escapement 下面的內(nèi)容會(huì)保持原義輸出
{literal}
function bazzy {alert('foobar!');}
{/literal}
</script>

{literal}…{/literal}塊被用來(lái)忽略模版語(yǔ)法的解析，你也可以用{idelim},{rdelim}標(biāo)簽或{smarty.Idelim}、{smarty.Idelim}、{smarty.rdelim}變量來(lái)忽略個(gè)別大括號(hào)（譯注：后面兩種方法主要用來(lái)在模版中輸出左右大括號(hào)）。