Smarty模板语法详解
这篇文章主要介绍了Smarty模板语法,结合实例形式详细分析了Smarty模板的注释、变量、引号、函数等基本语法与使用技巧,需要的朋友可以参考下。
本文实例讲述了Smarty模板语法，分享给大家供大家参考，具体如下：
所有模版标签用分隔符包围，默认为“{”和“}”。
模板注释
模板注释被星号包围，两边星号被定界符“{ }”包围，如 { smarty * }
smarty注释不会在模板文件的最后输出中出现，这与不同（译注：html注释在页面源码中可见，而smarty注释则不能）。
如下简单代码片{smarty}在源码中不可见，而源码可见。
- <html>
- <head>
- <tltle>smarty</tltle>
- <body>
- {*smarty*}
- smarty
- <!--smarty-->
- </body>
- </head>
- </html>
变量初步
模板变量用美元符号开始，可以包含数字、字母和下划线，这php很像。（注意：配置文件变量是一个不用美元符号开始，可以包含数字、字母和下划线，这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.Idelim}、{smarty.rdelim}变量来忽略个别大括号（译注：后面两种方法主要用来在模版中输出左右大括号）。