一般而言,網頁傳統方式的匯入外部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" />
編譯後的模板緩衝是:
<?phpif(isset($_GET['name'])): ?><script type="text/javascript" src="/Public/Js/Util/Array.js"></script><?phpendif;?>
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" />