Download the PHP package digitallyhappy/assets without Composer
On this page you can find all versions of the php package digitallyhappy/assets. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download digitallyhappy/assets
More information about digitallyhappy/assets
Files in digitallyhappy/assets
Package assets
Short Description Dead-simple way to load CSS or JS assets only once per page, when using Laravel 8+.
License MIT
Homepage https://github.com/digitallyhappy/assets
Informations about the package assets
Assets
Replace your <script src='file.js'>
and <link href='file.css'>
tags with @loadOnce('file.css')
and @loadOnce('file.js')
and this package will make sure that CSS or JS will only be loaded one time per page.
Installation
Via Composer
Usage
Replace your standard CSS and JS loading HTML with the @loadOnce()
Blade directive this package provides:
The package provides three Blade directives, in 99% of the cases you'll use @loadOnce()
:
However, if you want to pass a variable as the parameter, not a string, you'll notice it won't work, because the directive can't tell if it's a CSS, JS or code block. That's why we've created @loadStyleOnce()
and @loadScriptOnce()
:
Why does this package exist?
In Laravel 8+, if your CSS or JS assets are loaded inside a blade file:
And you load that blade file multiple times per page (eg. include card.blade.php
multiple times per page), you'll end up with that script
tag being loaded multiple times, on the same page. To avoid that, Larvel 8 provides the @once
directive, which will echo the thing only once, no matter how many times that blade file loaded:
But what if your script.js
file is not only loaded by card.blade.php
, but also by other blade templates (eg. hero.blade.php
, loaded on the same page? If you're using the @once
directive, you will have the same problem all over again - that same script loaded multiple times.
That's where this package comes to the rescue. It will load the asset just ONCE, even if it's loaded from multiple blade files.
Change log
Please see the changelog for more information on what has changed recently.
Testing
Contributing
Please see contributing.md for details and a todolist.
Security
If you discover any security related issues, please email [email protected] instead of using the issue tracker.
Credits
- Cristian Tabacitu
- All Contributors
License
MIT. Please see the license file for more information.