Gallery:主题:参考:修改器
Smarty修改器基础[ ]
Smarty使用修改器来用不同的方式显示文本,比如将一个字串显示为大写字母,小写字母或标题。模板中的任何变量都可以被应用上一个修改器,只要带上一个竖杠标记('|
')和某修改器名称即可:
使用修改器[ ]
{$user.userName} |
不改变格式的情况下显示变量$user.userName
|
{$user.userName|upper} |
使用upper 修改器以大写字母显示变量$user.userName
|
将若干个修改器串链在一起[ ]
使用竖杠就可以将若干个修改器串链在一起了:
{$user.userName|upper|strip_tags} |
先使用upper 修改器接着是strip_tags 修改器的方式来显示变量$user.userName
|
对修改器使用参量[ ]
某些修改器可以使用参量来控制它们的行为,比如内置的Smarty修改器 truncate
可以截取给定长度的字串。期望的字串长度作为一个参量传输给修改器:
{$user.userName|truncate:20} |
以20个字符的长度显示变量$user.userName
|
如果一个修改器有若干个参量的话,它们就必须按顺序进行传输,以冒号隔开。不愿为其赋值的可选参量的冒号之后的数值将被省略掉:
{$user.userName|truncate:20::true:true} |
显示变量$user.userName 并向truncate 修改器传输四个参量:
|
深入了解修改器[ ]
有关在模板中使用修改器以及Smarty中内置修改器的更详细信息可在 Smarty 手册中找到。
Gallery2的Smarty修改器[ ]
Gallery2向Smarty添加额外的修改器进行文本格式化以为gallery所用。包括有:
entitytruncate[ ]
用法: entitytruncate
:length:etc:breakWords
entitytruncate
修改器截取一个字串,但禁止在HTML实体或multibyte字符的中部的截取
参量:
length
(整数)-输出字段的最大长度etc
(字串)-用于后置到某被截取的字串,默认为3个句号('...')breakWords
(boolean) – 如为true,entitytruncate
将在中部截断某字串。默认为false
ireplace[ ]
用法: ireplace
:search:replace
ireplace
作为一个大小写敏感的搜索,并替换它所修改的变量,将search
替换为replace
参量:
search
(字串)-变量中进行查找的字串replace
(字串)-替换search
的字串
markup[ ]
用法: markup
markup
修改器根据站点管理设定中设置的标记格式(raw HTML,BBCode或无格式)来格式化某个变量
print_r[ ]
用法: print_r
此修改器用于debug,并且如果某变量含有子键(subkey)的话,就会递归式地将其打印出来。更多有关print_r
关键词的信息可在PHP手册中找到
repeat[ ]
用法: repeat
:count
repeat
修改器按指定次数重复某变量
参量:
count
(整数)-此repeat
所修改的变量重复次数
split[ ]
用法: split
:separator:regexp
split
将某变量截断为使用给定分隔符的数组。有关split
的更多信息可在PHP手册中查到
参量:
separator
(字串)–此字串标注变量应被截断的位置regexp
(boolean) - iftrue
thenseparator
解析为一个正则表达式。默认为false