ThinkPHP模板引擎之导入资源文件方法详解

内容摘要

一般而言，网页传统方式的导入外部JS和CSS等资源文件的方法是直接在模板文件使用：

<script type='text/javascript' src='/Public/Js/Util/Array.js'>
<link rel="stylesheet

文章正文

一般而言，网页传统方式的导入外部JS和CSS等资源文件的方法是直接在模板文件使用：

<script type='text/javascript' src='/Public/Js/Util/Array.js'>
<link rel="stylesheet" type="text/css" href="/App/Tpl/default/Public/css/style.css" />

ThinkPHP的模板引擎提供了专门的标签来简化上面的导入。

1.import标签

第一个是import标签，导入方式采用类似ThinkPHP的import函数的命名空间方式，例如：

<import type='js' file="Js.Util.Array" />

Type属性默认是js，所以下面的效果是相同的：

<import file="Js.Util.Array" />

还可以支持多个文件批量导入，例如：

<import file="Js.Util.Array,Js.Util.Date" />

导入外部CSS文件必须指定type属性的值，例如：

<import type='css' file="Css.common" />

上面的方式默认的import的起始路径是网站根目录下的Public目录，如果需要指定其他的目录，可以使用basepath属性，例如：

<import file="Js.Util.Array" basepath="./Common" />

如果导入的文件中含有“.”号，则可以采用：

<import file="Js.Util.Array#min" />

表示导入 /Public/Js/Util/Array.min.js 资源文件。

还支持资源文件的版本号导入，例如：

<import type='js' file="Js.Util.Array?v=120" />

在导入多个文件的时候也可以支持

<import type='js' file="Js.Util.Array?125,Js.Util.Date?130" />

improt标签支持判断加载，例如下面首先判断name变量是否设置：

<import type='js' file="Js.Util.Array" value="name" />

或者更复杂的，甚至可以采用函数：

<import type='js' file="Js.Util.Array" value="Think.get.name|isset" />

编译后的模板缓存是：

<?php
if(isset($_GET['name'])): 
?>
<script type="text/javascript" src="/Public/Js/Util/Array.js"></script>
<?php
endif;
?>

2.load标签

第二个是load标签，通过URL方式导入当前项目的公共JS或者CSS，例如：

<load href="/Public/Js/Common.js" />
<load href="/Public/Js/Date.js?v=235" />
<load href="/Public/Css/common.css" />

在href属性中可以使用特殊模板标签替换，例如：

<load href="!-PUBLIC-!/Js/Common.js" />

Load标签无需指定type属性，系统会自动根据后缀自动判断。
当然，load标签也支持条件判断调用：

<load href="/Public/Js/Common.js" value="name" />

系统还提供了两个标签别名js和css 用法和load一致，例如：

<js href="/Public/Js/Common.js" />
<css href="/Public/Css/common.css" />

load标签也支持同时导入多个资源文件，甚至是不同类型的资源文件：

<load href="/Public/Js/Common.js,/Public/Css/common.css" />

代码注释

学的不仅是技术，更是梦想！