在 WordPress 项目中，正确地注册和加载 CSS 和 JavaScript 文件至关重要，但传统的 wp_enqueue_scripts 方法往往会导致代码冗余和管理混乱。例如，当需要在特定条件下加载资源、处理依赖关系、或者在多个插件和主题之间协调资源时，问题会变得更加复杂。
stellarwp/assets 库提供了一套优雅的 api，用于注册、管理和加载 wordpress 中的 css 和 javascript 资源。它解决了以下常见问题：
- 代码冗余： 通过集中管理资源注册，减少重复代码。
- 依赖管理： 清晰地定义资源之间的依赖关系，确保加载顺序正确。
- 条件加载： 根据特定条件动态加载资源，避免不必要的加载。
- 版本控制： 方便地管理资源版本，避免缓存问题。
- 性能优化： 支持自动加载 minified 文件，提升页面加载速度。
使用 Composer 安装 stellarwp/assets 非常简单：
composer require stellarwp/assets
配置
在使用 stellarwp/assets 之前，需要进行一些基本的配置。在你的插件或主题的入口文件中，添加以下代码：
use StellarWP\Assets\Config;
add_action( 'plugins_loaded', function() {
Config::set_hook_prefix( 'your-plugin-prefix' );
Config::set_path( plugin_dir_path( __FILE__ ) );
Config::set_version( '1.0.0' );
// 可选：设置相对资源路径，默认为 `src/assets/`
Config::set_relative_asset_path( 'assets/' );
} );注册和加载资源
立即学习“前端免费学习笔记（深入）”；
stellarwp/assets 提供了简洁的 API 来注册和加载资源。以下是一些示例：
- 简单注册：
use StellarWP\Assets\Asset;
Asset::add( 'my-style', 'css/my-style.css' )
->register();- 指定依赖关系：
Asset::add( 'script-with-dependencies', 'js/something.js' )
->set_dependencies( 'jquery', 'jquery-ui' )
->register();- 条件加载：
Asset::add( 'my-asset', 'css/some-asset.css' )
->set_condition( 'is_single' )
->register();- 自动加载 minified 文件：
Asset::add( 'my-asset', 'js/some-asset.js' )
->set_min_path( 'assets/build/' )
->register();- 手动加载：
use StellarWP\Assets\Assets;
Assets::instance()->enqueue(
[
'my-style',
'my-script',
]
);优势和实际应用效果
stellarwp/assets 库带来了以下优势：
- 提高开发效率： 简洁的 API 简化了资源管理，减少了开发时间。
- 提升代码质量： 清晰的依赖关系和条件加载，提高了代码的可读性和可维护性。
- 优化前端性能： 自动加载 minified 文件，减少了 HTTP 请求，提升了页面加载速度。
在实际应用中，stellarwp/assets 可以用于：
- 插件开发： 管理插件的前端资源，避免与其他插件或主题冲突。
- 主题开发： 组织主题的 CSS 和 JavaScript 文件，提高主题的性能和可定制性。
- 大型项目： 集中管理项目的所有前端资源，提高团队协作效率。
stellarwp/assets 提供了一个强大而灵活的解决方案，用于解决 WordPress 资源管理中的各种问题。通过使用这个库，你可以提高开发效率，提升代码质量，并优化前端性能。
