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

2024-04-11 02:07:03 455

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

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

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

1.import标签

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

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

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

<importfile="Js.Util.Array"/>

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

<importfile="Js.Util.Array,Js.Util.Date"/>

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

<importtype='css'file="Css.common"/>

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

<importfile="Js.Util.Array"basepath="./Common"/>

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

<importfile="Js.Util.Array#min"/>

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

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

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

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

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

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

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

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

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

编译后的模板缓存是：

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

2.load标签

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

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

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

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

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

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

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

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

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

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