nystudio107 / craft-closure
Allows you to use arrow function closures in Twig
Fund package maintenance!
khalwat
Installs: 31 161
Dependents: 2
Suggesters: 0
Security: 0
Stars: 22
Watchers: 6
Forks: 3
Open Issues: 0
Type:yii2-extension
Requires
- php: ^8.0
- craftcms/cms: ^4.3.0 || ^5.0.0
- twig/twig: ^3.0.0
Requires (Dev)
- craftcms/ecs: dev-main
- craftcms/phpstan: dev-main
- craftcms/rector: dev-main
This package is auto-updated.
Last update: 2024-10-08 20:47:33 UTC
README
Closure for Craft CMS
Allows you to use arrow function closures in Twig
While Closure is a bit of a monkey patch, it's a pretty clean/simple one that relies on functionality that is already built into Twig
Requirements
Closure requires Craft CMS 4.x or 5.x
Installation
To install Closure, follow these steps:
-
Open your terminal and go to your Craft project:
cd /path/to/project
-
Then tell Composer to require the package:
composer require nystudio107/craft-closure
About Closure
Twig supports arrow function closures, but only in the filter, map, and reduce filters.
Twig unfortunately has no plans to allow for more widespread usage of arrow function closures.
Craft Closure allows you to use arrow function closures anywhere, which is especially useful with Laravel Collection methods, many of which take a closure as a parameter.
Using Closure
Once you've added the nystudio107/craft-closure
package to your project, no further setup is needed. This is because it operates as an auto-bootstrapping Yii2 Module.
You can then pass an arrow function closure as a parameter to anything that accepts them, such as many Laravel Collection methods:
{% set collection = collect(['a', 'b', 'c']) %} {% set contains = collection.contains((value, key) => value == 'z') %}
Or you can assign an arrow function closure to a Twig variable for re-use:
{% set collection = collect(['a', 'b', 'c']) %} {% set closure = (value, key) => value == 'a' %} {% set contains = collection.contains(closure) %}
Using arrow function closures especially useful now that Craft element queries can all return a Collection via the .collect() method.
More on Arrow Functions in Twig
More here: Twig Arrow Functions
Closure Roadmap
Some things to do, and ideas for potential features:
- Initial release
Brought to you by nystudio107