codenom/assets

为 CodeIgniter 4 提供资产发布和加载

1.0 2020-07-25 09:29 UTC

This package is auto-updated.

Last update: 2024-09-25 17:56:17 UTC


README

为 CodeIgniter 4 提供资产发布和加载

快速开始

  1. 使用 Composer 安装: > composer require codenom/assets
  2. 将 CSS 和 JS 文件放在: public/assets
  3. 将额外资产添加到配置: app/Config/Assets.php
  4. 在 head 标签中添加: <?= service('assets')->css() ?>
  5. 添加到页脚: <?= service('assets')->js() ?>

特性

为 CodeIgniter 4 提供 CSS 和 JavaScript 文件的原生加载功能

安装

通过 Composer 轻松安装以利用 CodeIgniter 4 的自动加载功能,并始终保持最新状态

  • > composer require codenom/assets

或者,通过下载源代码并将目录添加到 app/Config/Autoload.php 来手动安装。

配置(可选)

可以通过库的配置文件覆盖或增强库的默认行为。将 examples/Assets.php 复制到 app/Config/Assets.php 并按照注释中的说明进行操作。如果没有找到配置文件,库将使用其默认设置。

用法

如果安装正确,CodeIgniter 4 将检测并自动加载库、服务和配置。使用库方法 css()js() 显示特定路由的资产标签: <?= service('assets')->css() ?>

结构

库将在资产目录(默认: public/assets)中搜索与当前路由匹配的文件,并按路由段级联加载这些文件。

示例: https://example.com/users/view/30

库将首先加载任何根资产(public/assets/*.css *.js),然后是 "users" 子目录中的资产(public/assets/users/),然后是 "view" 子目录,然后是 "12" 子目录。任何缺失或无效的目录都将被忽略。

可以通过配置变量 $routes 指定额外的资产 - 这对于包含预捆绑库尤其有帮助。$routes 将每个路由映射到为该路由加载的资产文件或资产目录。

示例

public $routes = [
	'' => [
		'bootstrap/dist/css/bootstrap.min.css',
		'bootstrap/dist/js/bootstrap.bundle.min.js'
	],
	'files/upload' => [
		'vendor/dropzone'
	]
];

这告诉库为每个路由加载 Bootstrap 资产(''),而无需将其从预捆绑子目录中移动。它还将为指定的路由加载 dropzone 目录中的任何资产。