Layui穿梭框如何限制左侧列表的最大选择数量

阿浩姑娘_2439

阿浩姑娘_2439

2026-05-13

552人浏览

原创

layui transfer 组件无内置最大选中数限制,需手动监听dom点击拦截、单独处理全选按钮,并在render done回调中持久化选中状态,否则reload后状态丢失。

layui transfer 组件没有内置最大选中数限制

layui 的 transfer 组件本身不提供 maxchecked 或类似配置项,左侧列表(data 源数据)的勾选行为完全由 form 模块接管,而 form 对 checkbox 的统一监听无法区分 transfer 内部的复选框。直接套用 form.on('checkbox') 会误伤其他表单控件,且无法精准定位到 transfer 的左侧项。

必须监听 transfer 渲染后的 DOM 并手动拦截点击

transfer 渲染后,左侧列表每一项的复选框结构固定:<input type="checkbox" name="transfer[0]">(name 值含索引)。需在 transfer.render() 完成后,用事件委托监听其左侧容器(class 为 layui-transfer-box layui-transfer-box1)内的点击:

  • 先统计当前已勾选的左侧项数量:$('input[name^="transfer["][type="checkbox"]:checked').length
  • 若已达上限(如 3),且用户点击的是未勾选的 checkbox,则调用 event.preventDefault() 阻止默认行为
  • 立即更新 checkbox 状态(设为 checked = false),再调用 form.render('checkbox') 同步 UI
  • 注意:不能只靠 return false,Layui 的 checkbox 渲染依赖 form.render(),否则界面与状态不同步

左侧全选按钮需单独处理

transfer 的左侧“全选”按钮(class layui-transfer-header 下的 checkbox)触发时,name 为 transferAll1。它不走普通 checkbox 监听逻辑,必须额外绑定:

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

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

下载
  • 监听 click 事件而非 form.on,目标是 .layui-transfer-box1 .layui-transfer-header input[type="checkbox"]
  • 获取当前左侧所有可选项数量:$('.layui-transfer-box1 .layui-transfer-body li').length
  • 计算剩余可勾选数:MAX_SELECT - 已勾选数;若 ≤ 0,直接取消全选状态并提示
  • 若 > 0,只勾选前 剩余数 个未勾选项(用 :not(:checked):lt(N) 选取),再 form.render('checkbox')

跨页或动态刷新时状态易丢失

transfer 不维护内部选中状态,每次 transfer.render() 或 transfer.reload() 都会重绘 DOM,导致手动设置的勾选状态清空。解决办法只有两个:

  • 把已选 ID 存在外部变量(如 window.transferSelected = []),并在每次 render 的 done 回调里遍历 data,对匹配项手动设 checked = true,再 form.render('checkbox')
  • 避免 reload,改用 JS 动态增删 data 数组后调用 transfer.set({data: newData})(Layui 2.8+ 支持),该方法保留已有勾选状态
  • 切勿在 done 里直接操作 input.checked 后不调 form.render(),否则 checkbox 图标不会变

实际限制逻辑最脆弱的一环不是点击拦截,而是状态持久化——只要 reload 或重新 render,没做显式恢复,之前选中的就没了。这个细节多数人第一次写就会漏。

相关文章

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

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

下载

相关标签:

layui

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

相关专题

更多
ajax教程
ajax教程

php中文网为大家带来ajax教程合集,Ajax是一种用于创建快速动态网页的技术。通过在后台与服务器进行少量数据交换,Ajax可以使网页实现异步更新。这意味着可以在不重新加载整个网页的情况下,对网页的某部分进行更新。php中文网还为大家带来ajax的相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

2023.06.14

2800

4

ajax中文乱码解决方法
ajax中文乱码解决方法

ajax中文乱码解决方法有设置请求头部的字符编码、在服务器端设置响应头部的字符编码和使用encodeURIComponent对中文进行编码。本专题为大家提供ajax中文乱码相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.31

360

5

ajax传递中文乱码怎么办
ajax传递中文乱码怎么办

ajax传递中文乱码的解决办法:1、设置统一的编码方式;2、服务器端编码;3、客户端解码;4、设置HTTP响应头;5、使用JSON格式。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2023.11.15

2613

5

ajax网站有哪些
ajax网站有哪些

使用ajax的网站有谷歌、维基百科、脸书、纽约时报、亚马逊、stackoverflow、twitter、hacker news、shopify和basecamp等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.09.24

1161

6

Python uv使用教程
Python uv使用教程

本专题汇总了 Python uv 使用教程与高效使用指南,从 uv 安装配置、常用命令到虚拟环境、依赖管理与项目打包,系统讲解如何用 uv 替代 pip 与 poetry,全面提升 Python 项目开发效率,助你快速上手这一现代化包管理工具,打造干净高效的 Python 工作流。

2026.10.15

0

15

剧云AI短剧创作教程合集
剧云AI短剧创作教程合集

本专题聚焦剧云AI短剧创作,讲解从短剧灵感、梗概、全局大纲到分集、分场和正文的完整流程及节奏设计方法。

2026.10.14

0

15

剧云AI剧本创作零基础入门
剧云AI剧本创作零基础入门

本专题系统讲解剧云AI剧本创作流程,涵盖灵感、梗概、大纲、分场与正文生成,帮助新手快速完成首个中文剧本项目。

2026.10.14

0

14

VibeKnow文档转视频操作指南
VibeKnow文档转视频操作指南

本专题讲解VibeKnow上传Word、TXT、Markdown等材料生成视频的方法,覆盖内容解析、脚本组织、画面生成与成片检查。

2026.10.14

0

15

VibeKnow知识视频制作与导出详解
VibeKnow知识视频制作与导出详解

本专题整理VibeKnow从注册、素材上传、AI生成到预览导出的完整操作,帮助新手快速制作第一条知识讲解视频。

2026.10.14

0

13

热门下载

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

精品课程

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

共87课时 | 12.9万人学习

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

共89课时 | 11.1万人学习

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

共5课时 | 1.6万人学习