Smarty模板语法

最新推荐文章于 2021-08-14 19:51:38 发布

Sams-ara

最新推荐文章于 2021-08-14 19:51:38 发布

阅读量1.9k

点赞数 2

CC 4.0 BY-SA版权

分类专栏： Smarty 文章标签： smarty php

本文链接：https://blog.youkuaiyun.com/jingege0318/article/details/54142312

Smarty 专栏收录该内容

4 篇文章

订阅专栏

本文介绍了Smarty模板语言的使用，包括模板注释、变量初步、函数、属性、数学运算以及如何忽略Smarty语法。 Smarty的模板注释不会出现在输出中，变量可以用美元符号表示，并在双引号中插入。函数和属性用于控制输出和行为，而Math允许直接进行数学运算。为了在JavaScript或CSS中使用Smarty变量，可以利用{literal}...{/literal}或改变定界符来忽略语法解析。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

所有模版标签用分隔符包围，默认为“{”和“}”。

模板注释

模板注释被星号包围，两边星号被定界符“{ }”包围，如 { 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>