Smarty的标签都是使用定界符括起来。 默认定界符是{
和}
, 但定界符可以被改变
注释
{* 这是一个注释 *}
变量
模板变量以美元符号$开头,由字母、数组和下划线组成,和 PHP variable相似。 变量可以引用数字索引或非数字索引的数组,对象的属性和方法等。
举例:
{$foo} <-- 显示简单的变量 (非数组/对象)
{$foo[4]} <-- 在0开始索引的数组中显示第五个元素
{$foo.bar} <-- 显示"bar"下标指向的数组值,等同于PHP的$foo['bar']
{$foo.$bar} <-- 显示以变量$bar值作为下标指向的数组值,等同于PHP的$foo[$bar]
{$foo->bar} <-- 显示对象属性 "bar"
{$foo->bar()} <-- 显示对象成员方法"bar"的返回
{#foo#} <-- 显示变量配置文件内的变量"foo"
{$smarty.config.foo} <-- 等同于{#foo#}
{$foo[bar]} <-- 仅在循环的语法内可用,见{section}
{assign var=foo value='baa'}{$foo} <-- 显示"baa", 见{assign}```
**配置变量**
[配置变量](http://www.smarty.net/docs/zh_CN/language.config.variables.tpl) 是例外的,它不是以美元符号$开头,而是放到两个井号中间```#hashmarks#```, 或者通过```$smarty.config```来使用。
**函数**
每个Smarty的标签都可以是显示一个变量或者调用某种类型的函数。调用和显示的方式是在定界符内包含了函数,和其属性, 如:```{funcname attr1="val1" attr2="val2"}```
- 包括[内置函数](http://www.smarty.net/docs/zh_CN/language.builtin.functions.tpl) 和[自定义函数](http://www.smarty.net/docs/zh_CN/language.custom.functions.tpl) 都是用同样的语法调用。
- 内置函数是工作在Smarty**内部**的函数, 类似 [{if}
](http://www.smarty.net/docs/zh_CN/language.function.if.tpl), [{section}
](http://www.smarty.net/docs/zh_CN/language.function.section.tpl)和 [{strip}
](http://www.smarty.net/docs/zh_CN/language.function.strip.tpl)等等。 它们不需要进行修改或者改变。
- 自定义函数是通过[插件](http://www.smarty.net/docs/zh_CN/plugins.tpl)定义的**额外的**函数。 你可以任意修改自定义函数,或者创建一个新的函数。 [{html_options}
](http://www.smarty.net/docs/zh_CN/language.function.html.options.tpl)就是一个自定义函数的例子。
**属性**
大多数函数都会使用属性来定义或者修改它们的行为。
Smarty函数中的属性比较像HTML语法中的属性。静态值不需要引号引起来,但必须是纯字符串。带或不带修饰器的变量都可以使用,而且也不需要引号, 甚至可以使用PHP函数的结果,插件结果和复杂的表达式。
一些属性要求布尔值(TRUE或 FALSE)。 它们可以直接写成```true```和```false```。如果属性没有被赋值,那么它会将true作为默认值。
举例:
{include file="header.tpl" attrib_name="attrib value"}
{assign var=foo value={counter}} // 插件结果
{assign var=foo value=substr($bar,2,5)} // PHP函数结果
{assign var=foo value=$bar|strlen} // 使用修饰器
{assign var=foo value=$buh+$bar|strlen} // 复杂的表达式
{html_select_date display_days=true}说明:
{assign}用于在模板运行期间赋值给变量。
var-被赋值的变量名,
value-赋的值,
scope-变量的作用范围:
'parent','root' 或 'global'```
双引号中嵌入变量
- Smarty可以识别出在双引号中嵌套的 变量值 --> 这些变量名称必须只包括 字母、数字和下划线。比如:
{func var="test $foo_bar test"} // 识别变量 $foo_bar
- 如果该变量带有其他字符的,如点号(.)或者 $object->reference形式的, 必须用
单引号
括起来。比如:
{func var="test `$foo.bar` test"} // 识别变量 $foo.bar
- Smarty3中允许在双引号中嵌入Smarty的标签并运行。比如:
{func var="test {time()} test"} // PHP函数结果
数学计算
变量值内可以直接进行数学计算。比如:
{$foo*$bar}
{$foo->bar-$bar[1]*$baz->foo->bar()-3*7}```
**避免Smarty解析**
有时候部分模板中的代码是不需要或者不希望被Smarty解析的, 比较典型的例子是嵌入在页面HTML中的Javascript或CSS代码。 但这些语言会经常使用{ 和 },也恰好是Smarty的定界符。
- 解决方法一:避免被解析的一个好方法,是将Javascript/CSS代码分离到单独的文件中, 然后在HTML中引入它们。而且这样也有利于浏览器进行缓存。
- 解决方法二:Smarty模板中,当{ 和 }定界符两边都是空格的时候,将会被自动忽略解析。
- 解决方法三:```{literal}..{/literal}```可以让块中间的内容忽略Smarty的解析。在需要使用定界符的时候,可以通过```{ldelim}...{rdelim}```标签,或者```{$smarty.ldelim}...{$smarty.rdelim}```的变量来使用。
- 解决方法四:自定义 定界符。通过修改Smarty的```$left_delimiter```和```$right_delimiter```的变量值,设置更适合的定界符。比如:
<?php
$smarty->left_delimiter = '';
?>```
<!--{然后我们就要这样使用定界符了}-->
var foo = <!--{$foo}-->;
{debug}
我们可以使用smaty的{debug}来调试代码,YOUTUBE教程
网友评论