Asset 進階 - 类別

优质

小牛编辑

140浏览

2023-12-01

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 类别的静态方法也会使用预设实例。记得这件事，如果你修改了预设实例的配置（例如搜寻路径）！