|主题

|theme 过滤器返回一个相对于网站活动主题路径的地址。结果是一个绝对 URL，包括域名和协议，指向过滤器参数中指定的资产。主题资产通常位于主题目录的 assets 子目录中。

<script type="text/javascript" src="{{ 'assets/js/menu.js'|theme }}"></script>

如果网站地址是 https://octobercms.com 并且当前活动主题名为 website 上述示例将输出以下内容：

<script type="text/javascript" src="http://october.com/themes/website/assets/js/menu.js"></script>

结合 CSS 和 JavaScript

过滤器也可以通过传递一个文件数组来组合同类型的资产。

<link href="{{ [
    'assets/css/styles1.css',
    'assets/css/styles2.css'
]|theme }}" rel="stylesheet">

注意：您可以通过 enableAssetMinify 参数在 config/cms.php 脚本中启用资产最小化。默认情况下最小化是禁用的。

合并器别名

资源组合器支持用于替代文件路径的常用别名，这些别名将以 @ 符号开头。例如，AJAX 框架资源 可以包含在组合器中。

<script src="{{ [
    '@framework.extras',
    'assets/javascript/app.js'
]|theme }}"></script>

支持以下别名：

:: tip
相同的别名可用于 JavaScript 或 CSS，例如 @framework.extras。 数组中至少需要一个带 CSS 或 JS 文件扩展名的其他引用，来确定使用哪一个。
:::

外部组合器路径

在某些情况下，您可能希望合并主题之外的文件，这可以通过在路径前加上一个符号来创建动态路径实现。例如，以 ~/ 开头的路径将创建一个相对于应用程序的路径：

<script src="{{ ['~/modules/system/assets/js/framework.js']|theme }}"></script>

这些符号支持用于创建动态路径：

该 |theme 过滤器返回一个相对于网站当前主题路径的地址。结果是一个绝对 URL，包括域名和协议，指向在过滤器参数中指定的资产。主题资产通常位于主题目录的 assets 子目录中。

代码块0

如果网站地址是 https://octobercms.com 并且活动主题名为 website 上述示例将输出以下内容：

代码块1

结合 CSS 和 JavaScript

该过滤器也可以通过传入文件数组的方式来组合相同类型的资产。

代码块2

注意：你可以通过 config/cms.php 脚本中的 enableAssetMinify 参数启用资源文件压缩。默认情况下，压缩功能是禁用的。

合并器别名

资产合并器支持用于替代文件路径的常用别名，它们以 @ 符号开头。例如，AJAX 框架资产可以包含在合并器中。

代码块_3

支持以下别名：

:: tip
同一个别名可以用于 JavaScript 或 CSS，例如 @framework.extras。数组中需要至少一个带有 CSS 或 JS 文件扩展名的其他引用，以确定使用哪一个。
:::

外部组合器路径

在某些情况下，您可能希望组合主题之外的文件，这通过在路径前添加一个符号来创建动态路径实现。例如，以 ~/ 开头的路径将创建一个相对于应用程序的路径：

代码块4

支持这些符号用于创建动态路径：