Create inline partials in your Blade templates with ease.
This package introduces a new @capture directive that allows you to capture small parts of your Blade templates and re-use them later on without needing to extract them into partials.
Installation
You can install the package via Composer:
composer require ryangjchandler/blade-capture-directive
Usage
This package adds a new pair of directives: @capture and @endcapture.
The @capture directive will capture all of your Blade until it reaches an @endcapture directive. It takes the code and stores it inside of a variable for usage later on.
@capture($hello)
Hello, world!
@endcapture
The directive requires at least 1 argument. This argument should be a PHP variable that you would like to assign your partial to. The variable itself will become a Closure that can be invoked inside of Blade echo tags ({{ }}) anywhere after it's definition.
@capture($hello)
Hello, world!
@endcapture
{{ $hello() }}
The above code will invoke your captured Blade code and output Hello, world! when compiled by Laravel and rendered in the browser.
The @capture directive also supports arguments. This means you can capture generalised chunks of Blade and change the output dynamically. This is achieved by specifying a comma-separated list of PHP variables like so:
@capture($hello, $name)
Hello, {{ $name }}!
@endcapture
The above code will require that a name is passed to $hello(), like below:
@capture($hello, $name)
Hello, {{ $name }}!
@endcapture
{{ $hello('Ryan') }}
The Blade will compile this and your view will output Hello, Ryan!. Cool, right?
The list of arguments can be treated like any set of arguments defined on a function. This means you can assign default values and specify multiple arguments:
@capture($hello, $name, $greeting = 'Hello, ')
{{ $greeting }} {{ $name }}!
@endcapture
{{ $hello('Ryan') }}
{{ $hello('Taylor', 'Yo, ') }}
The above code will now output Hello, Ryan! as well as Yo, Taylor!. This is really cool, I know!
Testing
composer test
Changelog
Please see CHANGELOG for more information on what has changed recently.
Contributing
Please see CONTRIBUTING for details.
Security Vulnerabilities
Please review our security policy on how to report security vulnerabilities.
Credits
License
The MIT License (MIT). Please see License File for more information.
155 Dec 10, 2022
1.2k Jan 5, 2023
19 Jul 5, 2021
194 Dec 1, 2022
138 Dec 7, 2022
225 Sep 16, 2022
28 Nov 28, 2022
4 Dec 12, 2022
325 Jan 5, 2023
23 Dec 30, 2022
15 Oct 29, 2022
5 Oct 15, 2021
17 Aug 25, 2022
12 Jan 17, 2022
151 Dec 6, 2022
59 Dec 5, 2022
370 Dec 23, 2022
4 Oct 22, 2022