置顶 精华

Dcat-Plus Admin v3.0.11 发布:四项表单编辑体验升级

作者头像
杨光
1个月前
30 0

基于 Laravel + Bootstrap 的极速后台开发框架,只需很少的代码即可快速构建一个功能完善的高颜值后台系统。

dcat-plus/laravel-admin v3.0.11 正式发布(2.x 版本线同步发布 v2.0.28,内容完全一致)。本次共 4 项更新,全部围绕表单编辑与内容录入体验,逐条说明如下。

🚀 升级方式

# 3.x
composer require dcat-plus/laravel-admin:^3.0

# 2.x(v2.0.28,内容一致)
composer require dcat-plus/laravel-admin:^2.0

环境要求:PHP >= 8.3,Laravel 12 ~ 13。


更新一:Markdown 编辑器支持粘贴图片自动上传

说明:以前在 Markdown 编辑器里插图片,需要先保存文件、再上传图床、复制链接、手写 ![]() 语法。现在直接 Ctrl+V 粘贴,剪贴板中的图片自动上传,成功后 ![](url) 语法自动插入到光标处。

特性细节:

  • 走编辑器原有 imageUploadURL 上传通道,disk/dir 存储配置、文件类型白名单校验照常生效,无需任何额外配置,开箱即用;
  • 一次粘贴多张图片时逐张上传、逐张插入,上传过程有 toast 提示,失败会提示错误信息;
  • 纯文本粘贴不受任何影响;只读字段不启用。

使用方式(无代码,直接操作):在编辑器内按 Ctrl+V / Cmd+V 粘贴截图即可:


更新二:$form->table() 字段达到 useTable 同款表格体验

说明:$form->table() 用一个 JSON 列存多行数据(无需建关联表),但此前渲染简陋——表头空白、每格带 label、help 提示挤在单元格内。本次对齐 hasMany()->useTable() 的完整表格化体验,同一段字段定义在两处表现完全一致。

代码示例:

$form->table('items', '报名项目', function (NestedForm $table) {
    $table->select('item_type', '类型')
        ->options(['ticket' => '个人报名', 'team' => '团体报名'])
        ->default('ticket');
    $table->text('name', '项目名称');
    $table->decimal('price', '单价(元)')
        ->columnWidth('120px')           // 列宽:渲染到表头 <th>
        ->default(0)
        ->help('个人=每人价(¥260/人);团体=每队价(¥3280/队)');  // help 上收表头
    $table->number('quota', '名额(0不限)')->default(0);   // 默认列宽 100px + 居中
    $table->switch('is_enabled', '启用')->default(1);     // 默认列宽 70px + 居中
});

渲染效果:

  • 结构化表头:列名 + 列宽(columnWidth() 显式指定,或按字段类型给默认值:select 150px / number 100px / switch 70px / textarea 200px)+ 对齐方式(switch、number 自动居中);
  • help 上收表头:字段上的 ->help() 不再挤在单元格里,而是变成表头的 ❓ 图标,鼠标悬浮显示气泡说明;
  • 行内紧凑化:隐藏 label、去掉 Text 字段默认前置图标、textarea 默认行数收敛为 2、number 微调按钮收窄;
  • 迁移零成本:已有 hasMany()->useTable() 的字段定义,原样搬进 $form->table() 即可换成 JSON 单列存储,表单代码一行不改;
  • 顺带修复了所有存量 table 字段表头列空白的老问题。

更新三:嵌套表格新增行的 select 恢复下拉箭头

说明:一个隐蔽但天天见的 bug——hasMany/table 表格里点"新增",新增行的下拉框没有向下箭头,看起来就是个普通输入框,用户意识不到可以点开选择。

根因:AdminLTE 主题给 select.form-control 设置了 appearance: none(预期由 select2 渲染箭头),而框架的组件初始化机制不监听动态插入的 DOM——新增行克隆模板后,select 永远等不到 select2 挂载。

修复效果:

  • 新增行追加后自动挂载 select2,与初始数据行的渲染完全一致(箭头、选中回显、交互);
  • 同时给原生 select 恢复原生箭头作为兜底——即便未来出现 select2 挂不上的场景,下拉框也"长得像下拉框",可点开、可提交;
  • hasMany() 默认模式与 ->useTable() 表格模式一并修复。

更新四:Markdown 编辑器全屏按钮悬浮到右上角

说明:"全屏(按ESC还原)"按钮原本埋在 40 多个工具按钮中间,编辑长文想进全屏得找一会儿。现在初始化后该按钮自动悬浮在编辑器右上角:

  • 一眼可见、一点即进全屏;
  • 全屏状态下按钮继续悬浮在右上角,再点即退出(ESC 依然有效);
  • 按钮风格与工具栏一致(白底描边、hover 反馈),并适配深色模式;
  • 工具栏预留了右侧空间,不会遮挡原有工具按钮。

🔗 链接

  • 在线演示(laravel13 + php8.4,3.x):https://laravel13.dcat-admin.com/admin
  • GitHub:https://github.com/ycookies/dcat-plus-admin
  • 官方网站 / 文档:https://www.dcat-admin.com
  • 技术社区:https://down.dcat-admin.com/forum

💬 交流与支持

  • 加作者微信 Q3664839,加入 dcat-admin 开发交流群;
  • 欢迎Star / 提 Issue / 提 PR,也欢迎赞助开源,让 Dcat-Plus 走得更远。

Dcat-Plus Admin —— 汇聚 Filament、Laravel-Admin、Dcat-Admin 优点于一身的 Laravel 极速开发框架。写更少的代码,交更棒的活。

评论 (0)

登录 后参与评论
暂无评论,快来抢沙发
作者头像

杨光

这个人很懒,什么都没留下

社区规范

  • 遵守法律法规,禁止违规内容
  • 尊重他人,友善交流
  • 发帖审核通过奖励 10积分
  • 帖子加精额外奖励 20积分