PHPackages rapidez/blade-directives - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Templating & Views](/categories/templating) 4. / 5. rapidez/blade-directives ActiveLibrary[Templating & Views](/categories/templating) rapidez/blade-directives ======================== Expanded blade directives 1.1.0(1y ago)3104.6k↓39.8%33GPL-3.0-or-laterPHPPHP ^8.0|^8.1|^8.2|^8.3|^8.4 Since Jun 28Pushed 1y ago3 watchersCompare [ Source](https://github.com/rapidez/blade-directives)[ Packagist](https://packagist.org/packages/rapidez/blade-directives)[ Docs](https://rapidez.io)[ RSS](/packages/rapidez-blade-directives/feed)WikiDiscussions master Synced 1mo ago READMEChangelog (10)Dependencies (1)Versions (19)Used By (3) Rapidez 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`](#attributes) - [`@includeFirstSafe`](#includefirstsafe) - [`@markdown`](#markdown) - [`@return`](#return) - [`@slots`](#slots) - [`@slotdefault` + `@endslotdefault`](#slotdefault) - [`@includeCached`](#includecached) Installation ------------ [](#installation) ``` composer require rapidez/blade-directives ``` Directives ---------- [](#directives) ### @attributes [](#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 [](#usage) [Example](https://github.com/rapidez/statamic/blob/066b5d336e44890c5b4049f5df3c62b15ed302b2/resources/views/page_builder/form.blade.php#L9) ``` 'text', 'id' => 'test', 'name' => 'some_name'])/> ``` which will result in ``` ``` ### @includeFirstSafe [](#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 [](#usage-1) [Example](https://github.com/rapidez/statamic/blob/066b5d336e44890c5b4049f5df3c62b15ed302b2/resources/views/page_builder.blade.php#L2) ``` @includeFirstSafe(['custom.admin', 'admin'], ['status' => 'complete']) ``` ### @markdown [](#markdown) You can use the `@markdown` directive to transform markdown into html. Basically, `{!! Str::markdown($text) !!}` but in directive form. #### Usage [](#usage-2) ``` @markdown($text) ``` ### @return [](#return) The `@return` blade directive simply stops any further processing of the current template #### Usage [](#usage-3) [Example](https://github.com/rapidez/statamic/blob/066b5d336e44890c5b4049f5df3c62b15ed302b2/resources/views/page_builder/form.blade.php#L5) ``` @return ``` Or only when a condition is true: ``` @return($someConditionIsTrue) ``` ### @slotdefault [](#slotdefault) When you've an optional slot this directive gives you a cleaner way of defining a fallback. Normally you do something like this: ``` @if ($slot->isEmpty()) This is default content if the slot is empty. @else {{ $slot }} @endif ``` #### Usage [](#usage-4) ``` @slotdefault('slot') This is default content if the slot is empty. @endslotdefault ``` ### @slots [](#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 [](#usage-5) Within your blade component: ``` @slots(['optionalSlot', 'anotherSlot' => ['contents' => 'dummy text', 'attributes' => ['class' => 'bg-red-500']]]) {{ $slot }} attributes }}>{{ $optionalSlot }} attributes->class('text-black') }}>{{ $anotherSlot }} ``` If you enter nothing and only load in the component without passing any named slots it will be ``` dummy text ``` but if you were to pass the named slots it would look like this: ``` Regular slot text Optional content Optional content ``` ``` Regular slot text Optional content Optional content ``` 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. ``` Regular slot text ``` ``` Regular slot text Optional content Optional content ``` ### @includeCached [](#includecached) Just like [`@include`](https://laravel.com/docs/11.x/blade#including-subviews) but cached. Everything returned will be cached with [`Cache::flexible()`](https://laravel.com/docs/11.x/cache#swr) 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: ``` include-cache::site-{ Str::slug(url('/')) }-{ $viewName }' ``` #### Usage [](#usage-6) ``` @includeCached('view.name') ``` #### Notes [](#notes) Keep in mind that any dynamic things within the view will not be executed when cached. For example `@push`, see [Blade Stacks](https://laravel.com/docs/11.x/blade#stacks). Also [Blade Icons Deferring](https://github.com/blade-ui-kit/blade-icons#deferring-icons) doesn't work, you have to use these things outside the cached include! Helpers ------- [](#helpers) ### optionalDeep [](#optionaldeep) Have you heard of [optional()](https://laravel.com/docs/10.x/helpers#method-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 [](#usage-7) 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. ``` {{ optionalDeep($object)->undefinedKey->anotherUndefinedKey }} {{ optionalDeep($object)->header->usp->link->value() }} @if(optionalDeep($object)->header->usp->link->value()->isset()) @if(optionalDeep($object)->header->usp->link->value()->get() === 'test') ``` Tip the [OptionalDeep](https://github.com/rapidez/blade-directives/blob/master/src/OptionalDeep.php#L15) class implements Macroable, allowing you to extend it with your own functions! License ------- [](#license) GNU General Public License v3. Please see [License File](LICENSE) for more information. ### Health Score 47 — FairBetter than 94% of packages Maintenance45 Moderate activity, may be stable Popularity37 Limited adoption so far Community22 Small or concentrated contributor base Maturity70 Established project with proven stability Bus Factor1 Top contributor holds 57.5% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~38 days Recently: every ~25 days Total 17 Last Release 439d ago Major Versions 0.8.0 → 1.0.02024-11-27 PHP version history (2 changes)0.0.1PHP ^8.0|^8.1|^8.2 1.1.0PHP ^8.0|^8.1|^8.2|^8.3|^8.4 ### Community Maintainers ![](https://avatars.githubusercontent.com/u/72222911?v=4)[Rapidez](/maintainers/rapidez)[@rapidez](https://github.com/rapidez) --- Top Contributors [![royduin](https://avatars.githubusercontent.com/u/1703233?v=4)](https://github.com/royduin "royduin (23 commits)")[![indykoning](https://avatars.githubusercontent.com/u/15870933?v=4)](https://github.com/indykoning "indykoning (10 commits)")[![Jade-GG](https://avatars.githubusercontent.com/u/32514269?v=4)](https://github.com/Jade-GG "Jade-GG (4 commits)")[![Roene-JustBetter](https://avatars.githubusercontent.com/u/85165259?v=4)](https://github.com/Roene-JustBetter "Roene-JustBetter (2 commits)")[![JimmyHoenderdaal](https://avatars.githubusercontent.com/u/101801301?v=4)](https://github.com/JimmyHoenderdaal "JimmyHoenderdaal (1 commits)") --- Tags rapidez ### Embed Badge ![Health badge](/badges/rapidez-blade-directives/health.svg) ``` [![Health](https://phpackages.com/badges/rapidez-blade-directives/health.svg)](https://phpackages.com/packages/rapidez-blade-directives) ``` ### Alternatives [craftcms/cms Craft CMS 3.6k3.6M2.6k](/packages/craftcms-cms)[robsontenorio/mary Gorgeous UI components for Livewire powered by daisyUI and Tailwind 1.5k454.7k15](/packages/robsontenorio-mary)[livewire/blaze A tool for optimizing Blade component performance by folding them into parent templates 688221.3k17](/packages/livewire-blaze)[pressbooks/pressbooks Pressbooks is an open source book publishing tool built on a WordPress multisite platform. Pressbooks outputs books in multiple formats, including PDF, EPUB, web, and a variety of XML flavours, using a theming/templating system, driven by CSS. 44643.1k1](/packages/pressbooks-pressbooks)[rareloop/lumberjack-core A powerful MVC framework for the modern WordPress developer. Write better, more expressive and easier to maintain code 42155.0k19](/packages/rareloop-lumberjack-core)[konekt/html HTML and Form Builders for the Laravel Framework 24403.2k5](/packages/konekt-html) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)