Download the PHP package gehrisandro/tailwind-merge-laravel without Composer

On this page you can find all versions of the php package gehrisandro/tailwind-merge-laravel. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

Informations about the package tailwind-merge-laravel

TailwindMerge for Laravel

GitHub Workflow Status (main) Total Downloads Latest Version License


TailwindMerge for Laravel allows you to merge multiple Tailwind CSS classes and automatically resolves conflicts between classes by removing classes conflicting with a class defined later. This is especially helpful when you want to override Tailwind CSS classes in your Blade components.

A Laravel / PHP port of tailwind-merge by dcastil.

Supports Tailwind v3.0 up to v3.3.

If you find this package helpful, please consider sponsoring the maintainer:

If you are NOT using Laravel, you can use the TailwindMerge for PHP directly.

Table of Contents

Get Started

Requires Laravel 10

First, install TailwindMerge for Laravel via the Composer package manager:

Optionally, publish the configuration file:

This will create a config/tailwind-merge.php configuration file in your project, which you can modify to your needs using environment variables. For more information, see the Configuration section:

Finally, you may use TailwindMerge in various places like your Blade components:

TailwindMerge is not only capable of resolving conflicts between basic Tailwind CSS classes, but also handles more complex scenarios:

It's possible to pass the classes as a string, an array or a combination of both:

Usage

For in depth documentation and general PHP examples, take a look at the gehrisandro/tailwind-merge-php repository.

Use in Laravel Blade Components

Create your Blade components as you normally would, but instead of specifying the class attribute directly, use the mergeClasses method:

Now you can use your Blade components and pass additional classes to merge:

This will render the following HTML:

Note: Usage of $attributes->merge(['class' => '...']) is currently not supported due to limitations in Laravel.

Merge classes on multiple elements

By default Laravel allows you to only merge classes in one place. But with TailwindMerge you can merge classes on multiple elements by using twMergeFor():

You can now specify additional classes for the button and the svg icon:

This will render the following HTML:

Note: Use withoutTwMergeClasses() on your main attributes bag, otherwise all class:xyz attributes will be rendered in the output.

Use Laravel Blade Directive

The package registers a Blade directive which can be used to merge classes in your Blade views:

If you want to rename the blade directive, you can do so in the config/tailwind-merge.php configuration file:

You could even disable the directive completely by setting it to null:

Everywhere else in Laravel

If you don't use Laravel Blade, you can still use TailwindMerge by using the Facade or the helper method directly:

Facade

Helper Method

More usage examples

Take a look at the TailwindMerge for PHP repository.

Configuration

If you are using Tailwind CSS without any extra config, you can use TailwindMerge right away. And stop reading here.

If you're using a custom Tailwind config, you may need to configure TailwindMerge as well to merge classes properly.

By default TailwindMerge is configured in a way that you can still use it if all the following apply to your Tailwind config:

If some of these points don't apply to you, you need to customize the configuration.

Configure Prefix

You can configure the prefix directly in the config/tailwind-merge.php configuration file or by setting the environment variable:

Modify merge process

If TailwindMerge is not able to merge your changes properly you can modify the merge process by modifying existing class groups or adding new class groups.

For example, if you want to add a custom font size of "very-large":

For a more detailed explanation of the configuration options, visit the original package documentation.

Contributing

Thank you for considering contributing to TailwindMerge for Laravel! The contribution guide can be found in the CONTRIBUTING.md file.


TailwindMerge for PHP is an open-sourced software licensed under the MIT license.


All versions of tailwind-merge-laravel with dependencies

PHP Build Version
Package Version
Requires php Version ^8.1.0
guzzlehttp/guzzle Version ^7.5.1
laravel/framework Version ^10.9.0|^11.0
gehrisandro/tailwind-merge-php Version ^v1.1.0
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package gehrisandro/tailwind-merge-laravel contains the following files

Loading the files please wait ....