Download the PHP package tacman/twig-tree-tag without Composer
On this page you can find all versions of the php package tacman/twig-tree-tag. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download tacman/twig-tree-tag
More information about tacman/twig-tree-tag
Files in tacman/twig-tree-tag
Package twig-tree-tag
Short Description A Twig extension for succinctly traversing nested lists (e.g. navigation menus), supporting Twig 3
License MIT
Homepage https://github.com/tacman/twig-tree-tag
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package twig-tree-tag
twig-tree-tag
A Twig extension for succinctly traversing nested lists (e.g. navigation menus). Based on https://github.com/jordanlev/twig-tree-tag, adapted for PHP 8 and Twig 3 by Tac Tacelosky.
Requirements
Requires PHP 8.1 or higher
Installation
Now register it in services.yaml
Idea
The {% tree %} tag works almost like {% for %}, but inside a {% tree %} you can call {% subtree var %} to
recursively run your {% tree %} block with the given var. The primary use-case for this tag is nested navigation menus.
This extension was written by Alain Tiemblo, (with a few very minor changes by Jordan Lev).
Usage Example
In this example, menu is an array of objects, each containing name, url, and children properties (children is itself an array of objects with the same properties, etc).
Just like a {% for %} loop, you can access the key of each list item:
See the demo directory for more examples
What is the treeloop var?
The treeloop var serves the same purpose inside a {% tree %} tag as the loop var does inside a {% for %} tag. It is named differently so that you can still use loop when you have a {% for %} tag inside your {% tree %} tag (otherwise they would conflict).
treeloop contains all the same special variables as loop:
treeloop.index: The current iteration of the loop within the current nesting level. (1 indexed)treeloop.index0: The current iteration of the loop within the current nesting level. (0 indexed)treeloop.revindex: The number of iterations from the end of the loop within the current nesting level (1 indexed)treeloop.revindex0: The number of iterations from the end of the loop within the current nesting level (0 indexed)treeloop.first: True if first iteration of the current nesting leveltreeloop.last: True if last iteration of the current nesting leveltreeloop.length: The number of items in the sequence of the current nesting leveltreeloop.parent: The context of the parent nesting level (or the parent context of thetreetag itself if currently at the root level of the tree).
Additionally, treeloop also contains 2 extra variables that tell you about the current nesting level:
level: The current nesting level (1 indexed -- so root level of the tree is 1, 2nd-level is 2, etc)level0: The current nesting level (0 indexed -- so root level of the tree is 0, 2nd level is 1, etc)
What if I want a tree tag inside another tree tag?
To handle the edge case where you want to start a new tree inside another tree (that is, a new tree "root" with its own markup), use as in your {% tree %} tag to assign each tree to a var name, then pass it into subtree via with. This allows Twig to know which {% tree %} should be called when it comes across the {% subtree %} tag. For example...
License
The MIT License (MIT)
Please read the LICENSE file for more details.
