Download the PHP package artnv/tree-builder without Composer
On this page you can find all versions of the php package artnv/tree-builder. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download artnv/tree-builder
More information about artnv/tree-builder
Files in artnv/tree-builder
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 tree-builder
TreeBuilder
Библиотека для построения вложенных списков по типу родитель-потомок (Adjacency list). Можно применять для создания меню, списка категорий, вложенных комментариев, хлебных крошек и т.д.
Возможности:
- Уровень вложенности не ограничен
- Элементы в массиве могут идти непоследовательно, т.е. Потомок может быть выше или ниже родителя
- Библиотека доступна в двух версиях, для PHP и для Javascript
Пример: https://artnv.github.io/tree-builder/index.html
Еще больше примеров вы найдете в директории /php/
Установка
Через Composer
или добавить
в секцию require в файле composer.json
PHP
Входные данные для построения дерева
Обязательные поля: id, parent, title и position (если используется сортировка)
Алиасы
Данные из разных источников емеют разное название полей, чтобы их не менять, просто укажите их в качестве значений у ключей.
Если алиасы не переданы в качестве аргумента, то используются по умолчанию:
Параметры пользователя
Будут доступны в шаблонных методах rootNode и childNode
Сортировка
По умолчанию - true. В массиве должен быть ключ ['position'] чтобы сортировка работала, если его нет, отключите сортировку.
Для каждого узла с одним родителем ['parent_id'] позиция начинается с нуля и сортирует от большего числа к меньшему.
Шаблоны оформления дерева
В директории уже есть готовые примеры HtmlTree.php и SelectTree.php, а если вам нужен свой шаблон, то отнаследуйтесь от TreeBuilder и реализуйте интерфейс TreeBuilderInterface с двумя методами:
Дочерние узлы
$item- текущий элемент массива$childNodes- дочерние узлы текущего элемента-родителя$aliases- алиасы$nestingLevel- уровень вложенности (на основе этого значения можно добавлять линию для визуального оформления)$userParams- параметры пользователя
Корневой узел
$nodes- это данные из childNode()$firstStart- true, при первом запуске$userParams- параметры пользователя
Примеры использования
$tb->getTree()- возвращает ассоциативный массив$tb->showTree()- возвращает html дерево на основе шаблона$tb->getParents($node_1)- возвращает ассоциативный массив с цепочкой родительских узлов типа "хлебных крошек"$tb->getChilds($node_2)- возвращает ассоциативный массив с потомками конкретного узла
JavaScript
var tb = new TreeBuilder();- Вызов конструктораtb.setData(data);- Установка массива с даннымиtb.getTree();- Возвращает новый массив с объектамиtb.showTree();- Создает дерево в формате html (ul -> li), из массива с объектами
