标签库

ThinkPHP 模版中的标签库,我们使用的很多内置标签就是
通过标签库声明而来的,当然还可以自定义扩展标签。

 

一.内置标签

模版中的这些内置标签是是在  ThinkPHP/Library/Think/Template/TagLib  下

在完整版中提供了两个类文件: Cx.class.php (内置标签核心类)、 Html.class.php (html 扩展标签)

 

观察  Cx.class.php  源码,我们发现其实就是内置标签的核心类。比如:

 1 /**
 2      * volist标签解析 循环输出数据集
 3      * 格式:
 4      * <volist name="userList" id="user" empty="" >
 5      * {user.username}
 6      * {user.email}
 7      * </volist>
 8      * @access public
 9      * @param array $tag 标签属性
10      * @param string $content  标签内容
11      * @return string|void
12      */
13 public n function _volist($tag,$content) {
14             //核心代码省略
15 }

在 ThinkPHP 中,Cx.class.php 是自动加载的,所以并不需要各种配置或引入而可以直接编写标签代码即可运行。

但如果是 Html.class.php 这种扩展性标签库,则需要通过其他方式才可以运行:

 1 /**
 2      * select标签解析
 3      * 格式: <html:select options="name" selected="value" />
 4      * @access public
 5      * @param array $tag 标签属性
 6      * @return string|void
 7      */
 8     public function _select($tag) {
 9            //核心代码省略
10 }

如果要使用 Html.class.php 的扩展标签,那么首先要导入这个标签:

在 View/User/index.html 中导入:

1 //导入扩展标签
2  <taglib name="html" />

在使用标签的时候,前面需要加上html:,表示这个是html标签库

1  <html:select options="name" selected="value" /> 

PS:Cx.class.php 因为是内置标签,所以不需要加 Cx:,但 Html.class.php 则需要
加上 html:,否则会无法解析标签。

 

在 WeiBo/Common/Conf/config.php 中将Cx和Html都设置为内置标签

 

1 'TAGLIB_BUILD_IN'=>'cx,html',

 

1 //设置成内置标签,则不需要 html:了
2 <select options="name" selected="value" />

PS:设置内置标签有一定的危险性,因为可能会出现标签的重复导致冲突。就比如select标签,本来就属于html内的标签,所以调用 Html.class.php 就会产生冲突了。

 

 

 

如果没有设置为内置标签的话,那么都需要通过 tablib 进行导入,我们可以设置标签
预加载。这样,就不需要每次都进行导入操作了。

在 WeiBo/Common/Conf/config.php 中插入代码:

 

1 //标签预加载
2 'TAGLIB_PRE_LOAD'=>'html',

 

 

使用时在 Html.class.php 或者 Cx.class.php 里的调用标签的注释中查看调用格式,编译后的格式可在 Runtime/Cache/Home 中的缓存文件中查看。

 

二.扩展标签库

有时感觉内置的标签不能满足项目日益繁杂的项目需求,这是可能想自己扩展一些标签
来使用,那么自己怎么扩展标签呢?

第一步:在 Think/Library/Think/Template/TagLib 下创建一个 Test.class.php 

顶部的三行和 Cx.class.php 的顶部三行是一样的:

 

 1 namespace Think\Template\TagLib;
 2 use Think\Template\TagLib;
 3 defined('THINK_PATH') or exit();
 4 /**
 5  * Test标签库驱动
 6  */
 7 class Test extends TagLib{
 8     // 标签定义
 9     protected $tags   =  array(
10         'mytest'    => array('attr'=>'color,border','close'=>1),
11         );
12     public function _mytest($tag,$content) {
13         $color='';
14         $border='';
15         if(isset($tag['color'])) {
16             $color='color:'.$tag['color'];
17         }
18         if(isset($tag['border'])) {
19             $border='border:'.$tag['border'];
20         }
21         $css=$color.';'.$border;
22         return '<div style="'.$css.'">'.$content.'</div>';
23     }
24 }

 

其实就是跟着其他两个的格式来写就好。

其中 'close'=>1 是双标签,就是在引用标签的时候要收尾,比如在 View/User/index.html 引用时:

1 <Test:mytest color="red" border="5px solid blue">测试标签</Test:mytest>

后面必须加上 </Test:mytest> ,否则就引用不成功

 

其中  function _mytest($tag,$content)  的 $tag 就是获取 View/User/index.html 中的 color="red" border="5px solid blue" ,

可以在  function _mytest($tag,$content)  中使用  echo $tag;  来获得它的属性, $content 则是 View/User/index.html 

中的“测试标签

 

结果如下图:

 

另外当是否成功引用 ThinkPHP/Library/Think/Template/TagLib 下的文件时,可在调试工具下的文件中查看到:

posted @ 2015-05-18 16:48  todaytoday  阅读(318)  评论(0编辑  收藏  举报