一般而言,網頁傳統方式的導入外部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" />