Asset 类別

Asset 类別是一系列協助收集、分組和顯示資產(js、css、img)的方法。

進階用法

Asset 类別支援多个實例的使用。这可能被證明很有用,如果你正在使用主題, 而每个主題有它自己的一組資產,或者你正在开发一个模組化的应用程序, 而每个模組提供了自己的一組資產。

在这些情況中,只能有单一實例及使用搜尋路徑会不方便, 因为資產名稱碰撞的機会是相當高的,会導致你的应用程序載入错误的資產。

當你使用靜態方法,你可以依你想要的在一个 Asset 實例使用相同方法。 關於方法定義詳見类別用法頁面。

forge($config = array())

forge 方法能让你手动實例化一个 Asset 實例。

靜態
參数
參数 預設 描述
$name
null
請求的實例名稱。如果不存在,它将被鍛造。如果沒給名稱, 預設實例会被回傳。
$config
array()
當鍛造一个新的 Asset 實例,你可以傳遞一个自訂配置。 配置陣列與 asset 配置档案有相同結構。自訂配置将與記錄在这裡的預設配置, 以及在你的 asset 配置档案中的配置合併, 所以你只須傳遞你想變更的值。
回傳 物件 - 實例化的 Asset 物件。
範例
// 實例化一个 Asset 物件并帶著自訂搜尋路徑
$asset = Asset::forge('custom', array('paths' => 'custom/assets/');

// 定義一些 CSS 档案
$asset->css(array('header.css', 'footer.css'), array(), 'layout', false);

instance($name = null)

instance 方法能让你載入一个具名的 Asset 类別的實例。

靜態
參数
參数 預設 描述
$name
null
請求的實例名稱。如果不存在,false 会被回傳。如果沒給名稱, 預設實例会被回傳。
回傳 混合 - 具名的 Asset 實例或 false 如果實例不存在。
範例
// 實例化一个 Asset 物件并帶著自訂搜尋路徑
Asset::forge('custom', array('paths' => 'custom/assets/'));

// 使用已定義的實例來定義一些 CSS 档案
Asset::instance('custom')->css(array('header.css', 'footer.css'), array(), 'layout', false);

Asset 类別的靜態方法也会使用預設實例。記得这件事, 如果你修改了預設實例的配置(例如搜尋路徑)!