TailwindMerge for Laravel 使用教程
1. 项目的目录结构及介绍
gehrisandro/tailwind-merge-laravel
├── config
│ └── tailwind-merge.php
├── src
│ ├── Laravel
│ │ ├── Facades
│ │ │ └── TailwindMerge.php
│ │ └── TailwindMergeServiceProvider.php
│ └── TailwindMerge
│ └── TailwindMerge.php
├── tests
│ └── TailwindMergeTest.php
├── .gitattributes
├── .gitignore
├── CHANGELOG.md
├── CONTRIBUTING.md
├── LICENSE.md
├── README.md
├── composer.json
├── phpstan-baseline.neon
├── phpstan.neon
├── phpunit.xml
├── pint.json
├── rector.php
└── tailwind-merge.php
目录结构介绍
- config: 存放项目的配置文件,如
tailwind-merge.php
。 - src: 项目的源代码目录,包含主要的逻辑实现。
- Laravel: 针对 Laravel 框架的扩展和封装。
- Facades: Laravel 的 Facade 类,用于简化调用。
- TailwindMergeServiceProvider.php: Laravel 的服务提供者,用于注册和配置服务。
- TailwindMerge: 核心逻辑实现。
- Laravel: 针对 Laravel 框架的扩展和封装。
- tests: 测试代码目录,包含单元测试文件。
- .gitattributes: Git 属性配置文件。
- .gitignore: Git 忽略文件配置。
- CHANGELOG.md: 项目变更日志。
- CONTRIBUTING.md: 贡献指南。
- LICENSE.md: 项目许可证。
- README.md: 项目说明文档。
- composer.json: Composer 依赖管理文件。
- phpstan-baseline.neon: PHPStan 静态分析工具的基线配置。
- phpstan.neon: PHPStan 配置文件。
- phpunit.xml: PHPUnit 测试配置文件。
- pint.json: Laravel Pint 代码格式化工具配置。
- rector.php: Rector 代码重构工具配置。
- tailwind-merge.php: 项目的主要配置文件。
2. 项目的启动文件介绍
项目的启动文件主要涉及 Laravel 的服务提供者和 Facade 类。
TailwindMergeServiceProvider.php
该文件位于 src/Laravel/TailwindMergeServiceProvider.php
,是 Laravel 的服务提供者,用于注册和配置 TailwindMerge 服务。
TailwindMerge.php
该文件位于 src/TailwindMerge/TailwindMerge.php
,是 TailwindMerge 的核心逻辑实现,负责合并和处理 Tailwind CSS 类。
3. 项目的配置文件介绍
tailwind-merge.php
该配置文件位于 config/tailwind-merge.php
,用于配置 TailwindMerge 的行为。
配置示例
return [
'blade_directive' => 'customTwMerge', // 自定义 Blade 指令名称
'classGroups' => [
'font-size' => [
['text' => ['very-large']] // 自定义字体大小
]
]
];
环境变量配置
可以通过设置环境变量来配置 TailwindMerge:
TAILWIND_MERGE_PREFIX=tw-
发布配置文件
可以通过以下命令发布配置文件:
php artisan vendor:publish --provider="TailwindMerge\Laravel\TailwindMergeServiceProvider"
这将创建一个 config/tailwind-merge.php
配置文件,您可以根据需要进行修改。