Layui表单select如何实现分组显示(optgroup效果)

梦辰小哥_7595

梦辰小哥_7595

2026-06-22

311人浏览

原创

layui select 通过 JS 初始化 data 数组并设置 group 字段实现分组,要求 group 值为唯一字符串、同组项连续排列,且仅分组项含 group、选项项含 value 和 title;2.8+ 支持 form.select() 方法,旧版需伪分组模拟。

layui select 怎么用 optgroup 实现分组

layui 的 select 组件原生不支持 <optgroup></optgroup> 标签渲染,直接写在 html 里会被忽略。必须通过 js 初始化时传入结构化数据,由 layui 自动转换为带分组的下拉菜单。

核心是:不能靠 HTML 模板写 <optgroup></optgroup>,得用 data 数组 + group 字段(或自定义字段)驱动渲染。

  • layui 2.8+ 支持 group 字段标识分组项,同组项需连续排列
  • 每个选项对象必须含 value 和 title(或 name),分组项本身只设 group 字段,不设 value
  • 分组标题文字由 group 字段值决定,且该字段值需唯一(重复会导致渲染错乱)

初始化时传入带 group 的 data 数组

这是最稳妥的做法,绕过 HTML 解析限制,让 layui 在 JS 层完成分组逻辑。

layui.use(['form'], function(){
  var form = layui.form;

  // 注意:group 字段值必须是字符串,且同组项必须连续
  var selectData = [
    {group: '前端框架'},
    {value: 'vue', title: 'Vue.js'},
    {value: 'react', title: 'React'},
    {group: '后端语言'},
    {value: 'node', title: 'Node.js'},
    {value: 'python', title: 'Python'}
  ];

  // 渲染时指定 elem 和 data
  form.render('select', 'demo-filter'); // 先清空原有 select
  form.select({
    elem: '#mySelect',
    data: selectData,
    width: 200
  });
});

注意:form.select() 是 layui 2.8 新增方法,旧版本(如 2.7)不支持,强行调用会报 form.select is not a function 错误。

深蓝色网站后台管理系统layui框架模板-AdminPro
深蓝色网站后台管理系统layui框架模板-AdminPro

一款深蓝色网站后台管理系统layui框架模板

下载

旧版 layui(2.7 及以下)如何模拟 optgroup

没有 form.select() 就只能手动拼 HTML + 触发重新渲染,但要注意:layui 会过滤掉原生 <optgroup></optgroup>,所以得用「伪分组」方式——插入带样式的占位项,并禁用其选择。

  • 在原始 <select></select> 中添加 <option disabled>【前端框架】</option> 这类禁用项
  • 给这类 option 加 class(如 layui-select-group),再用 CSS 设置 color: #999; font-weight: bold;
  • 调用 form.render('select') 后,layui 生成的 layselect 面板中仍保留这些 option,但需额外 JS 禁用点击(因为 layui 不识别 disabled 属性)
  • 监听 select 的 change 事件,遇到 value 为空或匹配分组文本时,手动还原上一个有效值

常见错误和兼容性坑

分组失效、点击无反应、控制台报错,多数出在这几处:

  • data 数组里 group 值不是字符串(比如写了 group: 1),layui 内部判断失败,直接跳过分组逻辑
  • 同组项不连续(中间插了其他 group 或普通项),导致分组断裂,部分选项被归入错误分组
  • 混用 HTML 写法和 JS 初始化:先在 HTML 里写了 <optgroup></optgroup>,又调 form.render(),结果被清空重绘,<optgroup></optgroup> 彻底丢失
  • layui 版本低于 2.8 却照抄新版文档代码,form.select() 未定义,页面 JS 报错阻断后续执行

真正要稳定实现分组,优先升级到 layui 2.8+,并严格按 group 字段规则组织 data。低版本就接受「伪分组」的视觉妥协,别强求原生语义。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

layui

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
python是前端还是后端
python是前端还是后端

Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

2283

5

前端如何实现即时通讯
前端如何实现即时通讯

实现即时通讯的方法有WebSocket、Long Polling、Server-Sent Events、WebRTC等等。详细介绍:1、WebSocket,它可以在客户端和服务器之间建立持久连接,实现实时的双向通信,前端可以使用 WebSocket API来创建WebSocket连接,并通过发送和接收消息来实现即时通讯;2、Long Polling,是一种模拟实时通信的技术等等。

2023.10.09

4943

6

前端和后端的区别
前端和后端的区别

前端关注的是用户界面的设计和交互,而后端则注重数据处理和逻辑控制。想了解更多前端后端的相关内容,可以阅读本专题下面的文章。

2024.03.19

6030

13

php和前端的关联介绍
php和前端的关联介绍

php既可以作为前端语言,也可以作为后端语言。想了解更多php和前端的相关内容,可以阅读本专题下面的文章。

2024.03.22

5538

10

前端外包工作内容有哪些
前端外包工作内容有哪些

前端外包工作内容包括:1. 网站和应用程序开发;2. 用户界面和交互设计;3. 用户体验优化;4. 设计和视觉开发;5. 跨浏览器兼容性;6. 性能优化;7. 维护和更新;8. 项目管理和沟通。想了解更多前端的相关内容,可以阅读本专题下面的文章。

2024.05.22

783

5

html5动画制作有哪些制作方法
html5动画制作有哪些制作方法

html5动画制作方法有使用CSS3动画、使用JavaScript动画库、使用HTML5 Canvas等。想了解更多html5动画制作方法相关内容,可以阅读本专题下面的文章。

2023.10.23

3811

6

HTML与HTML5的区别
HTML与HTML5的区别

HTML与HTML5的区别:1、html5支持矢量图形,html本身不支持;2、html5中可临时存储数据,html不行;3、html5新增了许多控件;4、html本身不支持音频和视频,html5支持;5、html无法处理不准确的语法,html5能够处理等等。想了解更多HTML与HTML5的相关内容,可以阅读本专题下面的文章。

2024.03.06

6428

6

html5从入门到精通汇总
html5从入门到精通汇总

想系统掌握HTML5开发?本合集精选全网优质学习资源,涵盖免费教程、实战项目、视频课程与权威电子书,从基础语法到高级特性(Canvas、本地存储、响应式布局等)一应俱全,适合零基础小白到进阶开发者,助你高效入门并精通HTML5前端开发。

2025.12.30

774

19

html5新老标签汇总
html5新老标签汇总

HTML5在2026年持续优化网页语义化与交互体验,不仅引入了如<header>、<nav>、<article>、<section>、<aside>、<footer>等结构化标签,还新增了<video>、<audio>、<canvas>、<figure>、<time>、<mark>等增强多媒体与

2025.12.30

674

12

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
ThinkPHP配置开发与CMS后台实战
ThinkPHP配置开发与CMS后台实战

共87课时 | 12.7万人学习

第二十三期_综合实战
第二十三期_综合实战

共89课时 | 10.9万人学习

Layui 快速入门精讲
Layui 快速入门精讲

共5课时 | 1.6万人学习