Download the PHP package jacksleight/blade-tailor without Composer
On this page you can find all versions of the php package jacksleight/blade-tailor. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Informations about the package blade-tailor
Blade Tailor
Blade Tailor allows you to customise (tailor) the default props, classes and attributes used by blade components without publishing their templates. This is particularly useful for theming components from external packages. If you have a library of your own re-usable components you can also make those tailorable by using the tailor directive.
[!WARNING] This package needs to make some minor changes to external component templates during compilation, in order to hook into their rendering processes. These are limited to the components you're tailoring but there may be edge cases that result in unexpected behaviour.
Installation
Run the following command from your project root:
Usage
Tailoring Components
Tailoring components is done via the Tailor::component()
method. You can either make these calls in a service provider or create a dedicated file for your customisations in resources/tailor.php
(this will be loaded automatically). Whenever you add an alteration for a brand new component you need to run php artisan view:clear
, as the template will need to be recompiled. Further changes will not require recompiling.
The remove, replace and reset options are not slot specific, they will apply to all slots.
You'll need to add any files where you're defining alterations to your Tailwind config's content
array to ensure the compiler picks up the new classes:
Making Components Tailorable
If you have a library of your own re-usable components you can make them tailorable by replacing the @props
directive with @tailor
.
Technicailly this isn't really necessary, as the package will attempt to make this change itself if it detects a tailored component, however doing it explicitly ensures you have full control over the change.
Using Tailwind Merge
This package does not require Tailwind Merge as a dependency, but if it's installed it will be used when merging your custom classes with the default ones.
Using Tailwind Variant Shorthand
The tailor method supports a custom shorthand for specifying Tailwind variant classes:
To make this work with the Tailwind compiler you'll need to add a custom extract method for PHP files to your Tailwind config, which you can import from this package: