Download the PHP package rapidez/blade-directives without Composer
On this page you can find all versions of the php package rapidez/blade-directives. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download rapidez/blade-directives
More information about rapidez/blade-directives
Files in rapidez/blade-directives
Package blade-directives
Short Description Expanded blade directives
License GPL-3.0-or-later
Homepage https://rapidez.io
Informations about the package blade-directives
Rapidez Blade Directives
This package adds blade directives that we found we needed in Laravel during development of Rapidez. Like @slots
, which lets you define optional slots so your attributes->merge()
always works. Or @includeFirstSafe
which works the same as @includeFirst
but will not throw errors if no template was found. All directives included within this package:
@attributes
@includeFirstSafe
@markdown
@return
@slots
@slotdefault
+@endslotdefault
@includeCached
Installation
Directives
@attributes
The @attributes
blade directive allows you to pass the attributes for a html element using an array. It's functionally the same as the $attributes
of a blade component but you can use it outside of blade components!
Usage
which will result in
@includeFirstSafe
The @includeFirstSafe
blade directive works the same way that @includeFirst
does however it will not throw an error if all templates do not exsist.
Outside of production mode it will alert about the missing templates however.
Usage
@markdown
You can use the @markdown
directive to transform markdown into html. Basically, {!! Str::markdown($text) !!}
but in directive form.
Usage
@return
The @return
blade directive simply stops any further processing of the current template
Usage
Or only when a condition is true:
@slotdefault
When you've an optional slot this directive gives you a cleaner way of defining a fallback. Normally you do something like this:
Usage
@slots
The @slots
blade directive is used within blade components.
It is used to define optional named slots which will be created if they are not passed.
Very useful if named slots might not always be passed but you want to use the attributes
of this named slot
Usage
Within your blade component:
If you enter nothing and only load in the component without passing any named slots it will be
but if you were to pass the named slots it would look like this:
As you can see it has overwritten the class of the optional slot, but not the attributes->class()
If you only wish to change the text without changing attributes you can also pass them as attributes.
@includeCached
Just like @include
but cached. Everything returned will be cached with Cache::flexible()
for 5 minutes; and refreshed in the background until it expires after 24 hours. After that it will be refreshed as usual. The cache key is a combination of the view name and the current slugified url. That way this can be used with multisite setups:
Usage
Notes
Keep in mind that any dynamic things within the view will not be executed when cached. For example @push
, see Blade Stacks. Also Blade Icons Deferring doesn't work, you have to use these things outside the cached include!
Helpers
optionalDeep
Have you heard of optional()? This is the supercharged version working at any depth! It makes sure that any missing key will not break your code, especially helpful when mixing Statamic with Blade
Usage
It will automatically return the value when casting to string so you can immediately echo out it's value, if you want to get the value use the get method. This will return null if anywhere along the chain the value or key does not exist.
[!TIP] the OptionalDeep class implements Macroable, allowing you to extend it with your own functions!
License
GNU General Public License v3. Please see License File for more information.