PHPackages                             tourze/easy-admin-tree-select-field-bundle - 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. [Admin Panels](/categories/admin)
4. /
5. tourze/easy-admin-tree-select-field-bundle

ActiveSymfony-bundle[Admin Panels](/categories/admin)

tourze/easy-admin-tree-select-field-bundle
==========================================

Symfony bundle providing a tree select field for EasyAdmin with multiple data source support

1.0.0(6mo ago)06861MITPHPPHP ^8.2CI passing

Since Nov 1Pushed 4mo agoCompare

[ Source](https://github.com/tourze/easy-admin-tree-select-field-bundle)[ Packagist](https://packagist.org/packages/tourze/easy-admin-tree-select-field-bundle)[ RSS](/packages/tourze-easy-admin-tree-select-field-bundle/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (1)Dependencies (27)Versions (2)Used By (1)

EasyAdmin Tree Select Field Bundle
==================================

[](#easyadmin-tree-select-field-bundle)

[English](README.md) | [中文](README.zh-CN.md)

一个为 EasyAdmin 4 提供树形选择器字段的 Symfony Bundle，支持多种数据源。

特性
--

[](#特性)

- 🌳 **树形结构显示** - 直观的层级展示
- 🔍 **实时搜索** - 快速查找节点
- ✅ **多选/单选** - 灵活的选择模式
- 📱 **响应式设计** - 适配移动端
- 🎨 **主题支持** - 支持亮色/暗色模式
- 🔌 **多数据源** - 支持数组、Entity、回调函数等多种数据源
- ⚡ **懒加载** - 支持大数据集的按需加载
- 🎯 **易于集成** - 与 EasyAdmin 无缝集成

安装
--

[](#安装)

```
composer require tourze/easy-admin-tree-select-field-bundle
```

配置
--

[](#配置)

在 `config/bundles.php` 中注册 Bundle：

```
return [
    // ...
    Tourze\EasyAdminTreeSelectFieldBundle\EasyAdminTreeSelectFieldBundle::class => ['all' => true],
];
```

安装资源文件：

```
php bin/console assets:install
```

使用方法
----

[](#使用方法)

### 基本用法

[](#基本用法)

在 EasyAdmin CRUD 控制器中使用：

```
use Tourze\EasyAdminTreeSelectFieldBundle\Field\TreeSelectField;

public function configureFields(string $pageName): iterable
{
    yield TreeSelectField::new('categories')
        ->setData([
            ['id' => 1, 'label' => '根节点', 'parent_id' => null],
            ['id' => 2, 'label' => '子节点1', 'parent_id' => 1],
            ['id' => 3, 'label' => '子节点2', 'parent_id' => 1],
            ['id' => 4, 'label' => '孙节点', 'parent_id' => 2],
        ])
        ->setMultiple(true)
        ->setSearchable(true);
}
```

### 使用数组数据源

[](#使用数组数据源)

```
use Tourze\EasyAdminTreeSelectFieldBundle\DataProvider\ArrayTreeDataProvider;

yield TreeSelectField::new('categories')
    ->setDataProvider(new ArrayTreeDataProvider([
        ['id' => 1, 'name' => '电子产品', 'parent_id' => null],
        ['id' => 2, 'name' => '手机', 'parent_id' => 1],
        ['id' => 3, 'name' => '电脑', 'parent_id' => 1],
        ['id' => 4, 'name' => '智能手机', 'parent_id' => 2],
        ['id' => 5, 'name' => '功能手机', 'parent_id' => 2],
    ]))
    ->setMultiple(true);
```

### 使用 Entity 数据源

[](#使用-entity-数据源)

```
use Tourze\EasyAdminTreeSelectFieldBundle\DataProvider\EntityTreeDataProvider;

public function __construct(
    private EntityManagerInterface $entityManager
) {}

public function configureFields(string $pageName): iterable
{
    yield TreeSelectField::new('categories')
        ->setDataProvider(new EntityTreeDataProvider(
            $this->entityManager,
            Category::class,
            [
                'id_field' => 'id',
                'label_field' => 'name',
                'parent_field' => 'parent'
            ]
        ))
        ->setMultiple(true)
        ->setExpandedLevel(2);
}
```

### 使用自定义数据提供者

[](#使用自定义数据提供者)

创建自定义数据提供者：

```
use Tourze\EasyAdminTreeSelectFieldBundle\DataProvider\AbstractTreeDataProvider;
use Tourze\EasyAdminTreeSelectFieldBundle\Model\TreeNode;

class CustomTreeDataProvider extends AbstractTreeDataProvider
{
    public function getTreeData(array $options = []): array
    {
        // 从你的数据源获取数据
        $data = $this->fetchDataFromSource();

        // 转换为树节点
        $nodes = [];
        foreach ($data as $item) {
            $node = new TreeNode(
                $item['id'],
                $item['name'],
                $item['parent_id']
            );
            $nodes[] = $node;
        }

        return $this->buildTree($nodes);
    }

    public function getRootNodes(): array
    {
        // 返回根节点
    }

    public function getChildrenNodes(mixed $parentId): array
    {
        // 返回子节点
    }
}
```

使用自定义数据提供者：

```
yield TreeSelectField::new('categories')
    ->setDataProvider(new CustomTreeDataProvider())
    ->setMultiple(true);
```

配置选项
----

[](#配置选项)

TreeSelectField 提供了丰富的配置选项：

```
TreeSelectField::new('field_name')
    // 数据相关
    ->setDataProvider($provider)        // 设置数据提供者
    ->setData($arrayData)               // 直接设置数组数据

    // 选择相关
    ->setMultiple(true)                 // 是否多选
    ->setRequired(false)                // 是否必填
    ->setPlaceholder('请选择...')        // 占位符

    // 显示相关
    ->setExpandAll(false)               // 是否默认展开所有节点
    ->setExpandedLevel(2)               // 默认展开层级
    ->setMaxDepth(5)                    // 最大深度限制
    ->setShowCheckbox(true)             // 是否显示复选框

    // 功能相关
    ->setSearchable(true)               // 是否可搜索
    ->setSortable(false)                // 是否可排序
    ->setLazyLoad(false)                // 是否懒加载

    // 图标相关
    ->setNodeIcon('fa fa-folder')       // 节点图标
    ->setLeafIcon('fa fa-file')         // 叶子节点图标
;
```

节点数据格式
------

[](#节点数据格式)

节点数据支持以下格式：

```
[
    'id' => 1,                          // 节点ID（必需）
    'label' => '节点名称',               // 显示标签（必需）
    'parent_id' => null,                // 父节点ID
    'selectable' => true,               // 是否可选
    'expanded' => false,                // 是否默认展开
    'metadata' => [                     // 额外元数据
        'badge' => '新',
        'color' => 'primary'
    ]
]
```

事件监听
----

[](#事件监听)

在 JavaScript 中监听选择变化事件：

```
document.addEventListener('DOMContentLoaded', function() {
    const treeSelect = document.querySelector('.tree-select-widget');
    const originalSelect = treeSelect.querySelector('select');

    originalSelect.addEventListener('change', function(e) {
        console.log('Selected values:', e.target.value);
    });
});
```

样式自定义
-----

[](#样式自定义)

可以通过 CSS 变量自定义样式：

```
.tree-select-widget {
    --tree-border-color: #dee2e6;
    --tree-hover-bg: #f8f9fa;
    --tree-selected-bg: #e7f3ff;
    --tree-search-highlight: #fff3cd;
}
```

高级用法
----

[](#高级用法)

### 异步加载数据

[](#异步加载数据)

```
class AsyncTreeDataProvider extends AbstractTreeDataProvider
{
    public function getTreeData(array $options = []): array
    {
        // 只加载根节点
        return $this->getRootNodes();
    }

    public function getChildrenNodes(mixed $parentId): array
    {
        // 按需加载子节点
        // 这可以通过 AJAX 请求实现
        return $this->loadChildrenFromApi($parentId);
    }
}
```

### 节点权限控制

[](#节点权限控制)

```
class SecureTreeDataProvider extends AbstractTreeDataProvider
{
    public function getTreeData(array $options = []): array
    {
        $nodes = parent::getTreeData($options);

        // 根据用户权限过滤节点
        return array_filter($nodes, function($node) {
            return $this->userHasAccessToNode($node);
        });
    }

    private function userHasAccessToNode($node): bool
    {
        // 检查用户权限
        return true;
    }
}
```

故障排除
----

[](#故障排除)

### 资源文件未加载

[](#资源文件未加载)

确保已执行：

```
php bin/console assets:install --symlink
php bin/console cache:clear
```

### 树形结构不显示

[](#树形结构不显示)

检查数据格式是否正确，特别是 `parent_id` 字段。

### 搜索功能不工作

[](#搜索功能不工作)

确保设置了 `->setSearchable(true)`。

贡献
--

[](#贡献)

欢迎提交 Issue 和 Pull Request！

许可证
---

[](#许可证)

MIT License

###  Health Score

38

—

LowBetter than 84% of packages

Maintenance76

Regular maintenance activity

Popularity13

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity47

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% 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

Unknown

Total

1

Last Release

189d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/e354fdb316da535dfa8ba2e9193a473c403b6bc6fb9170778d1dc50e304c6e9d?d=identicon)[tourze](/maintainers/tourze)

---

Top Contributors

[![tourze](https://avatars.githubusercontent.com/u/13899502?v=4)](https://github.com/tourze "tourze (1 commits)")

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Type Coverage Yes

### Embed Badge

![Health badge](/badges/tourze-easy-admin-tree-select-field-bundle/health.svg)

```
[![Health](https://phpackages.com/badges/tourze-easy-admin-tree-select-field-bundle/health.svg)](https://phpackages.com/packages/tourze-easy-admin-tree-select-field-bundle)
```

###  Alternatives

[sylius/sylius

E-Commerce platform for PHP, based on Symfony framework.

8.4k5.6M647](/packages/sylius-sylius)[contao/core-bundle

Contao Open Source CMS

1231.6M2.3k](/packages/contao-core-bundle)[ec-cube/ec-cube

EC-CUBE EC open platform.

78527.0k1](/packages/ec-cube-ec-cube)[easycorp/easyadmin-bundle

Admin generator for Symfony applications

4.3k16.7M309](/packages/easycorp-easyadmin-bundle)[sulu/sulu

Core framework that implements the functionality of the Sulu content management system

1.3k1.3M152](/packages/sulu-sulu)[prestashop/prestashop

PrestaShop is an Open Source e-commerce platform, committed to providing the best shopping cart experience for both merchants and customers.

9.0k15.4k](/packages/prestashop-prestashop)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)