一般而言,网页传统方式的导入外部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" />