TailwindMerge for Laravel 使用教程

TailwindMerge for Laravel 使用教程

tailwind-merge-laravelAutomatically resolves Tailwind CSS class conflicts in Laravel项目地址:https://gitcode.com/gh_mirrors/ta/tailwind-merge-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: 核心逻辑实现。
• 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 配置文件，您可以根据需要进行修改。

tailwind-merge-laravelAutomatically resolves Tailwind CSS class conflicts in Laravel项目地址:https://gitcode.com/gh_mirrors/ta/tailwind-merge-laravel