README

2le 的 Crudit Bundle

安装

需要 Webpack Encore，并且需要在您的应用程序中设置安全性。

require 2lenet/crudit-bundle
npm install bootstrap@5 sass sass-loader @fortawesome/fontawesome-free easymde --save

只需在您的模板/base.html.twig 中添加以下行

{% extends '@LleCrudit/layout/sb_admin/layout.html.twig' %}

{% block stylesheets %}
    {{ encore_entry_link_tags('app') }}
{% endblock %}

{% block javascripts %}
    {{ parent() }}
    {{ encore_entry_script_tags('app') }}
{% endblock %}

然后，在您的 assets/js/app.js 中，您需要添加这一行

import '../styles/app.scss';

并在您的 assets/styles/app.scss 中添加这一行

@import '../../vendor/2lenet/crudit-bundle/assets/sb-admin/css/app.scss';

所有新的 SCSS 文件必须在 Crudit SCSS 导入之前导入。

食谱

原则

CRUD 由以下部分组成

一个独立的控制器
一个 CRUD 配置类
一个数据源
如果需要，则有一个过滤器集

布局和菜单与 CRUD 独立。您可以将自己的控制器轻松集成到 Crudit 布局中

功能

列表视图

列表视图具有以下功能

分页
排序
项目操作（显示、编辑和删除）
列表操作（添加和导出 CSV 和 Excel）
列表分组（以节省重复值的空间）
批量操作（请参阅批量操作）
可以根据传递给实体的类为行着色
可以自定义布局（待办事项 / 块原则）

列表视图需要一个数据源，但不是绑定到 Doctrine 或任何 ORM。

显示视图

显示视图具有以下功能

显示所有字段
标题可以使用实体通过其实体名称来命名对象
选项卡（请参阅选项卡）
子列表以显示相关数据
可以为主卡片和显示视图的标题着色
可以自定义布局（待办事项 / 块原则）

表单视图

编辑视图是一个经典的 Symfony 表单。您编写自己的 FormType

Crudit 提供了一些帮助以实现良好的集成

许多 FormType（日期时间、实体等）
基于 TomSelect 的实体下拉列表，具有自动完成功能
DoctrineFormGuesser 以自动使用 Crudit FormType。
基于 EasyMDE 的 Markdown 编辑器
可以自定义布局（待办事项 / 块原则）

JS 格式输入辅助工具

一些检查输入有效性的帮助（大写、电子邮件、IP 等）

inputFormat

依赖关系

Crudit 希望最小化对不太受欢迎的包或组件的依赖，以便能够长期维护此包，并无需解决依赖问题地跟踪 Symfony Stack 的开发。

布局灵感来源于 SB Admin 2，但部分重写。SB Admin 2 的许多功能对这个项目来说并不实用。

使用的 CSS 框架是 Bootstrap 5。

Excel 导出使用 phpoffice/phpspreadsheet。

预版本需要 Doctrine，但项目设计为无需它也能工作。如果您想使用其他数据提供者，请随时联系我们。

开发

待完善

设计原则

JS / CSS 开发

要更新 JS 或 CSS，请在包中运行。

npm install
npm run build

2lenet / crudit-bundle

维护者

详细信息