Smarty模板語法

所有模版標籤用分隔符包圍,默認爲“{”和“}”。

模板註釋

模板註釋被星號包圍,兩邊星號被定界符“{ }”包圍,如 { smarty * }
smarty註釋不會在模板文件的最後輸出中出現,這與不同(譯註:html註釋在頁面源碼中可見,而smarty註釋則不能)。
如下簡單代碼片{smarty}在源碼中不可見,而源碼可見。

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

變量初步

模板變量用美元符號php ,而是用#號包圍着變量(#hashmarks#),或者是一個$smarty.config形式的變量。)

這裏config不做說明,下面是變量示例:

{$a+$b}            //最簡單的變量處理方法
{$a={$b}+1}     //標籤嵌套標籤
{$array[$a]}   //變量做數組索引
{$assign var=fun value=$a+$b}    //變量賦值
{$fun="{a}"}   //引號套用標籤

{$assign var=fun value=[1,2,3]}
{$assign var=fun value=[1,2,[3,4]]}
{$assign var=fun value=[1=>'one',2=>'tow']}        //數組定義

{$fun=stlen($a)}
{fun=function($a,$b)}          //用作函數參數

{$array.a=1}
{$array.a.b.c($array[a][b][c])=1}    //數組索引賦值

{$object->method1($x)->method2($y)}     //對象鏈

雙引號中插入變量

1、Smarty可以識別嵌入在雙引號中的變量,只要此變量只包含數字、字母、下劃線和中括號[]。
2、對於句號,數組和對象引用等的符號此變量必須用兩個反引號`。
3、Smarty3增加了雙引號對Smarty標籤的支持。在需要包含調節器變量、插件、php函數返回值的情形中非常實用。

{function var="test $foo test"}              // 識別  $foo
{func var="test $foo_bar test"}             // 識別  $foo_bar
{func var="test `$foo[0]` test"}          // 識別  $foo[0]
{func var="test `$foo[bar]` test"}      // 識別  $foo[bar]


{func var="test $foo.bar test"}             // 識別   $foo (無法識別 $foo.bar) 
{func var="test `$foo.bar` test"}        // 識別  $foo.bar 
{func var="test `$foo.bar` test"|escape} //調節器在引號外
{func var="test {$foo|escape} test"}     // 調節器在引號內
{func var="test {time()} test"}               // PHP 函數識別
{func var="test {counter} test"}            //標籤識別

函數

每一個smarty標籤輸出一個變量或者調用某種函數。在定界符內函數(一般定界符‘{}’包住)和其屬性(同樣在定界符內)將被處理和輸出。例如: {function(函數名) 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、在模板裏無論是內置函數還是自定義函數都有相同的語法。
2、內置函數將在smarty內部工作,例如{if}、{section}和{strip},不能修改他們。
3、自定義函數通過插件機制起作用,它們是附加函數。只要你喜歡,可以隨意修改,你也可以自行添加。例如{html_options}和{html_select_date}。

屬性

大多數函數都帶有自己的屬性以便於明確說明或者修改他們的行爲,smarty函數的屬性很像HTML中的屬性。靜態數值不需要加引號,但是字符串建議使用引號。可以使用普通smarty變量,也可以使用帶調節器的變量作爲屬性值,它們也不用加引號。你甚至可以使用php函數返回值和複雜表達式作爲屬性值。

Math

數學運算可以直接作用到變量值。

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

忽略smarty語法

忽略Smarty對某些語句段的解析很有必要。一種典型的情況是嵌入到模板中的javascript或Css代碼。原因在於這些語言使用與Smarty默認定界符‘{’和‘}’一樣的符號。

方法:一個避免出現這種情況的好習慣是把你的javascript/css代碼分離出來保存成一個獨立文件,再用html方法鏈接到模版中。這樣做也有利於瀏覽器緩存腳本。如果你想把Smarty變量、方法嵌入到javascript/css,請看下面的運用。

在Smarty模版,如果‘{’和‘}’大括號裏包含有空格那麼整個{}內容會被忽略,你可以設置Smarty類變量$auto_literal=false來取消這種規則。

<script>
// the following braces are ignored by Smarty 以下大括號的內容會被Smarty忽略
// since they are surrounded by whitespace 因爲它們裏面有空格
function foobar {
alert('foobar!');
}
// this one will need literal escapement 下面的內容會保持原義輸出
{literal}
function bazzy {alert('foobar!');}
{/literal}
</script>

{literal}…{/literal}塊被用來忽略模版語法的解析,你也可以用{idelim},{rdelim}標籤或{smarty.Idelim}、{ smarty.rdelim}變量來忽略個別大括號(譯註:後面兩種方法主要用來在模版中輸出左右大括號)。

發佈了38 篇原創文章 · 獲贊 14 · 訪問量 4萬+
發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章