You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
layui/docs/versions.md

20 KiB

title toc
更新日志 true

更新日志

2.8.x

导读:📑 Layui 2.8 《升级指南》 · 📑 Layui 新版文档站上线初衷

2.8.3 2023-05-15

  • 基础

    • 新增 layui.debounce()layui.throttle(),分别用于防抖和节流 # 1252
  • form

    • 新增 checkbox 的标题模板支持,可在下一个兄弟元素中加上 lay-checkbox 绑定 # I72HSK/I6YDGT
    • 修复 radio 经浏览器翻译成别的语言后出现的显示异常问题 # I6ZA12
    • 优化 checkbox 的边距细节
    • 优化 checkbox 标签风格的边框瑕疵 # I70OFE
    • 调整 内置校验规则,仅当非空时进行校验,避免强制携带必填(required)的校验规则 # I72CTI
  • table

    • 新增 tool,checkbox,radio 事件的 obj.getCol() 方法,用于获取当前列的配置信息 # I72D2C
    • 新增 ignoreExport 表头属性,用于在表格导出时对该列进行忽略 # 1252
    • 修复 某些特殊情况,表格页脚出现双底线的问题 # I70BDR
    • 优化 合计行内数据超过单元格长度时,无法查看全部的问题 # I6TOP8
  • treeTable

    • 修复 默认的节点 icon 图标用错问题 # 1252
    • 修复 showIconfalse 在某些操作之后出现图标的问题 # 1252
    • 修复 展开全部之后再展开单个节点出现卡顿问题 # 1252
    • 修复 更新节点导致的图标重复及数据未正常更新的问题 # 1252
    • 修复 开启了 sort 属性后出现的一些异常问题 # 1252
  • layer

    • 新增 hideOnClose 属性,用于关闭弹层时设置为隐藏,默认 false。须与 id 属性并用 # I72L74
    • 修复 layer.min(index) 方法与最小化按钮事件效果不一致的问题 # I6ZD3R
    • 优化 基础配置信息的记录,统一记录在 layer 容器的 .data('config')
    • 优化 当弹层设置 id 并最小化后,再次点击事件时,重新还原弹层 # I5N0QP
  • laydate

    • 修复 点击限制范围外的标注日期仍然可点的问题,# I71D9C

下载: layui-v2.8.3.zip


2.8.2 2023-05-04

  • table

    • 修复 autoSort: true 时,更改 table.cache 未同步到 data 属性的问题 # 1247
    • 修复 多级表头存在 hide 表头属性时,执行完整重载可能出现的错位问题 # 1247/I6WX8Y
    • 修复 未开启 page 属性时底边框缺失问题 # 1228
    • 优化 打印内容中包含过大图片时的显示问题
  • treeTable

    • 修复 checkbox,radio 事件导致 table 组件不必要的异常提示问题 # I6Z5W5
    • 修复 执行重载并携带 parseDatadone 属性导致的渲染异常问题 # 1247
    • 修复 treeTable.updateNode() 方法执行无效的问题 # 1247
    • 修复 treeTable.expandAll() 方法隐藏所有节点导致统计栏消失的问题 # 1247
    • 修复 单元格事件中执行 obj.update() 方法导致树节点特征丢失的问题 # 1247/I6ZW2R
    • 优化 treeTable expandAll() 方法,支持展开所有节点 # 1247
    • 优化 内部代码的若干细节 # 1247
    • 调整 customName.rootId 属性为 data.rootPid
  • layer

    • 修复 tab 层的样式异常问题 # I6YS0F
  • form

    • 优化 checkbox 半选状态的样式 # I6YXVV
  • laydate

    • 优化 shortcuts 属性机制,当点击快捷选项时自动确认 #I6YQU6
  • menu

    • 优化 菜单项样式,以解决当点击菜单边缘时,未点击到 <a> 标签的问题
  • transfer

    • 优化 value 属性,按其顺序渲染初始值列表 # 1235
  • icon

    • 更新 Edge 图标
  • code

    • 新增 copy 属性,用于开启代码复制功能图标
    • 新增 onCopy 回调函数,用于自定义复制事件,而不触发内置的复制操作
    • 调整 encode 属性,默认 true,即开启对 code 的编码,且预览时强制开启

下载: layui-v2.8.2.zip


2.8.1 2023-04-25

  • 修复 table.reloadData() 未支持 page 属性的问题
  • 修复 treeTable 点击排序后导致树形结构功能异常的问题 # 1232/I6YGU6
  • 修复 layer 的 win10 风格并开启 icon 属性时信息框显示异常问题
  • 优化 switch 在选中前后的尺寸差异 # I6YJO4
  • 优化 colorpicker 点击颜色滑块时跳动到顶部的问题

下载: layui-v2.8.1.zip


2.8.0 2023-04-24

2.8.0-beta.1rc.16经二十个预览版的持续迭代Layui 终于迎来了:2.8.0 正式版。
同时,新域名下的 新文档站 也正式上线(导读:Layui 新版文档站上线初衷),新版文档亦开源在 Github 以供协同维护。

正是开发者们依然坚持的热爱,促使了 Layui 这一朴实的归来。

  • 基础

    • 优化 css 的构建,将原先 layer/laydate/code 的 css 统一构建到 layui.css,以尽量减少请求
    • 变更主色调为:#16baaa 在原有的墨绿基础上赋予了清新
    • 新增 18 个字体图标
    • 新增 grid 布局的超大屏 xl 响应式支持
    • 调整 layui.event() 方法,当组件事件中未设定 filter 时则可重复执行该事件 # 1135
    • 剔除 layer 等部分组件的图片资源,全部采用字体图标和纯 css 替代实现
    • 剔除 layedit 内置组件,详见:关于将在 v2.8.0 版本中正式剔除 layedit 组件的公告
    • lay: 优化 lay.options() 方法,以提供更直观的异常提示
  • layer

    • 新增 anim 属性的四个弹出方向的动画类,可实现边缘抽屉弹出,同时关闭时自动匹配对应的动画
    • 新增 skin 属性可选值 layui-layer-win10 ,可设置为 Windows 10 主题风格
    • 新增 success 等回调的第三个参数:即当前弹层实例对象,以便操作内部方法
    • 新增 photos 层的私有属性 hideFooter,用于控制是否隐藏图片底部栏
    • 新增 photos 层底部栏的「查看原图」功能
    • 新增 photos 层对 lay-src 属性的支持
    • 新增 prompt 层的 placeholder 属性 # 1136
    • 新增 removeFocus 属性,用于是否移除弹层触发元素的焦点,避免按回车键时重复弹出 # 1143
    • 新增 layer.closeLast(type) 方法,用于根据弹层类型关闭最近打开的层 # I66WI2
    • 优化 document 相关事件机制,避免全局事件叠加,以及大量弹出时可能存在的内存溢出
    • 优化 window resize 事件机制,避免事件不断叠加 # I38C2O
    • 优化 所有图标, 由原来的图片改为纯 css 和字体图标
    • 优化 创建弹层的初始化逻辑,以兼容 tampermonkey 等特殊应用场景
    • 优化 内部按钮标签,避免页面设置 <base target="_blank"> 时,点击按钮导致的打开新页面 # 830
    • 修复 多次调用 min/max 方法后再执行 restore 出现的异常问题 # 1135/I5QP66
    • 修复 最大化后再调整窗口大小出现的异常问题 # 1135/I5ROMW
    • 修复 最大/小后若浏览器窗口尺寸变化,再恢复状态后可能出现的不居中或大小异常问题 # 1135
    • 修复 最小化后再恢复后执行窗口 resize 时弹层的位置异常问题 # 1135
    • 修复 鼠标右键点击弹层可以区域时导致的弹层位置大小异常的问题 # 1143
    • 调整 prompt 层的确认回调,支持输入空值 # 1143/I5UO7N
    • 调整 除 msg/load/tips 层之外的弹出触发时的焦点,默认移除触发元素失去焦点 # 1143
  • table

    • 新增 cellMaxWidth 属性和表头 maxWidth 属性,以设定列的最大宽度
    • 新增 colResized 列拖拽宽度后的事件,并返回当前列的相关信息 # I3URH8/I3QDBI
    • 新增 colToggled 列筛选(显示或隐藏)后的事件,并返回当前列的相关信息 # I3URH8
    • 新增 返回数据中的 data 成员为非对象时的渲染支持,如 data: ["a","b","c"]
    • 新增 maxHeight 属性,用于定义表格的最大高度 # 1135/I5R6F6
    • 新增 fieldTitle 表头属性,用于定义表头字段标题,该属性在筛选列和导出场景中优先级高于 title 属性 # 1170
    • 新增 table.setRowChecked(id, opts) 方法,用于设置行选中状态 # I6CRL7
    • 新增 table.getOptions(id) 方法,用于获取指定 id 对应的表格实例配置项 # 1135
    • 新增 table.hideCol(id, cols) 方法,用于外部设置列的显示隐藏 # 1135/I5RUAJ
    • 新增 rowContextmenu 事件,用于显示行的右键菜单,需设置属性 defaultContextmenu:false 才生效 # 1188
    • 新增 事件返回的 obj.setRowChecked(opts) 方法,用于设置当前行选中状态
    • 加强 height 属性,可设置对父元素的高度自适应,如:height: '#父元素id-差值' # 1111
    • 修复 多级表头模式下的头部工具栏的筛选在重载并还原勾选后,表格存在错位问题 # 1107 # I5L0B4
    • 修复 size: 'sm' 时,设置 align: 'center' 单元格内容未完全居中的问题 # 1107
    • 修复 document 全局事件中对当前实例引用错误的问题 # 1107
    • 修复 表头 title 属性存在 html 标签时,头工具栏筛选栏列表中存在的异常问题 # 1107
    • 修复 width 属性小于 minWidth 时,通过拖拽列调整宽度却以 minWidth 为起点宽度的问题 # 1107
    • 修复 当开启 even:true 后,多行表头也会跟着变色的问题 # 1113
    • 修复 头工具栏筛选下拉面板被下方表格遮挡的问题,并重新优化了表格内部层级关系 # 763
    • 修复 列宽值为百分比时,其分配的宽度超出最大和最小宽度的异常问题 # 1128 I5LM4S
    • 修复 转换静态表格时,若为特殊的多级表头且存在初始主体数据时出现的错列问题 # 1135/I5QAZM
    • 修复 table.exportFile() 方法导出任意数据时的某些异常问题 # 1135/I5S17X
    • 修复 统计行在重载后可能出现滚动条补丁丢失,并导致跟主体对应不上的问题 # 1150
    • 修复 多级表头操作筛选列后可能出现的固定列高度异常问题 # 1170/I60WQ4
    • 修复 edit 事件中返回的 obj.data 中的对应字段未同步更新值的问题 # I6A6SL
    • 修复 点击排序后导致 scrollPos:'fixed' 失效的问题 # I68MBC
    • 修复 设置 align: 'center' 表头属性时,打印时的合计行未能跟随居中的问题
    • 修复 table.resize() 方法导致的在无数据或请求异常时的右侧固定列显示异常问题 # I6F72U
    • 优化 事件的回调参数,可返回当前实例配置项:config
    • 优化 edit 事件的核心逻辑,新增返回 obj.reedit() 方法,可实现编辑内容校验不通过时重新显示编辑
    • 优化 edit 事件的返回参数,新增返回 obj.oldValue 属性,用于获取字段修改前的旧值: #1107
    • 优化 edit 事件的返回参数,新增返回 obj.getCol() 方法,用于获取当前列表头配置信息
    • 优化 edit 开启后的对应单元格在鼠标 hover 时显示可编辑样式
    • 优化 radio 事件,当返回数据中存在 LAY_DISABLED 状态时不触发
    • 优化 templet 表头属性函数时返回的数据可包含 LAY_COL 特定字段
    • 优化 复杂表头细节,避免当组合表头的父级表头内容过长引起的错位问题 #1107
    • 优化 表头内容超长时可通过鼠标 hover 显示其完整内容 #1107
    • 优化 无数据时若列超出最大宽度,也显示横向滚动条,以便能查看到所有表头字段 #1110
    • 优化 过滤器,若目标元素未设 lay-filter 属性值,则自动取实例 id 值,以减少冗余的属性设置
    • 优化 导出文件功能,避免内容中存在某些特殊符导致的 excel/csv 表格错位,及避免内容被强制转换格式
    • 优化 内部模板标签符,避免 laytpl 全局设置的影响
    • 优化 UI 细节,以便整体视觉更为清爽。
    • 调整 page,limit 属性,当 page 未开启时,则默认不再向后端传递这两个参数 # I6G5BO
    • 调整 特定字段名称。序号: LAY_INDEXLAY_NUM;下标: LAY_TABLE_INDEXLAY_INDEX
  • treeTable new

    • 新增「树形表格」组件。可视为 table 组件的树形结构的延伸
    • 详细用法可参考文档(/docs/treeTable/
  • form

    • 新增 输入框的动静态点缀,可在前后缀添加图标等任意内容。其中动态点缀内置:清空、密码显隐功能
    • 优化 form.render() 方法,若参数一传入的 jQuery 对象指向表单域容器,则渲染该表单域中的所有表单项
    • 优化 select 选中时的样式
    • 优化 select 开启搜索时,在清空搜索框文本后重置选中项(而非保留上次选中的值)
    • 优化 checkbox、radiotitle 属性值为 HTML 内容的转义
    • 优化 checkbox 的内置风格,以支持半选效果 # 1224
    • 优化 radiochecked 机制,可通过 form.val() 方法取消单选框的选中 # 1224
    • 修复 select 子元素中以 <optgroup> 标签开头出现的异常问题 # I5MV17
    • 调整 checkboxlay-skin 属性默认为原始风格,标签风格值为 tag
    • 调整 checkbox 的私有属性 lay-text,采用统一的 title 属性替代
  • laydate

    • 新增 shortcuts 属性,用于开启面板左侧的快捷选择功能 # 1135
    • 新增 fullPanel 属性,当 datetime 类型且非 range 模式,可开启日期和时间在同一面板操作 #1128
    • 新增 theme 属性的多主题支持
    • 新增 circle 圆圈高亮的内置主题
    • 新增 autoConfirm 属性,用于开启选中目标值时即自动确认(默认 true # 1138/I5T3GW
    • 新增 shade 属性,用于开启弹出日期面板时的遮罩,其用法同 layer 的 shade 参数 # 1149
    • 新增 rangeLinked 属性,用于是否开启日期范围选择时的区间联动标注模式,默认不开启 # 1172
    • 新增 对目标元素重新 render 覆盖的支持 #1128
    • 新增 对目标元素上的 lay-options 属性识别,可覆盖 render 方法中的 options # 1128
    • 新增 laydate.getInst() 方法,可返回指定 id 或绑定节点上的 lay-key 属性值对应的实例 # 1128
    • 新增 laydate.unbind() 方法,可对目标元素解除当前实例的绑定 # 1128
    • 新增 onConfirm/onNow/onClear 三个属性,分别用于确认、现在、清空三个事件的回调 # I65ZQ6
    • 修复 当设置 min/max 后,年和月列表面板中对应的最小/大的年月值无法选中的问题 # 1128 I442FW
    • 修复 当前日期未在 min/max 设定的范围内,仍能点击现在按钮的问题 # 573
    • 修复 当开启 range 属性,并在浏览器缩放后面板出现换行的问题 # 1156
  • colorpicker

    • 新增 cancelclose 回调,分别用于在取消选择和面板关闭后触发 # I3SJC7
    • 优化 事件处理机制,避免 document 的事件重复绑定
    • 优化 组件选择块的尺寸(lg/md/sm/xs),以更好地应用于其他组件内(如 table)
    • 修复 rgba 值在 input 框中修改时会自动变成 16 进制的问题 # I5QPZZ
  • dropdown

    • 新增 clickScope 属性,用于设置触发点击事件的菜单范围(如 all 即代表父子菜单均可触发事件) # 3NRJD
    • 新增 shade 属性,用于开启弹出面板时的遮罩
    • 新增 datadisabled 属性的支持,以禁用某一菜单项 # I6GSCD
    • 新增 对绑定元素的 lay-options 属性识别,可与渲染方法的 options 属性合并
    • 新增 dropdown.reloadData(id, options) 方法,用于仅重载数据或内容 # 1224
    • 新增 dropdown.close(id) 方法,用于关闭对应的实例面板 # 1138
    • 优化 templet 属性,支持函数写法
    • 优化 click 回调函数,当其返回 return false 时,点击选项可不关闭面板 # I6DUMY
    • 优化 过滤器,若目标元素未设 lay-filter 属性值,则自动取实例 id 值,以减少冗余的属性设置
    • 修正 搜索框所在 input 元素的 type 值 # 1168
    • 修复 在移动设备下,点击其他元素无法关闭面板的问题 # 1189
    • 修复 show: true 时,ready 回调未执行的问题
  • element

    • 新增 nav 导航菜单浅色背景主题
    • 优化 nav 导航当前选中菜单样式
    • 修复 element.progress() 方法不支持更新分数值的问题 #622
  • upload

    • 调整 表单域 file 字段的顺序,以适应阿里云/腾讯云中的对象存储上传规则 # 1147
    • 修复 多上传设置文件大小限制时,删除超出大小的文件仍然校验不通过的问题 # I6LR5O
    • 新增 goto 方法,用于轮播跳转。可通过 var inst = carousel.render() 的实例获取 # 1128 I5LIWJ
    • 新增 对绑定元素的 lay-options 属性识别,可与渲染方法的 options 属性合并
    • 优化 elem 属性,可传入 class 选择器同时绑定多个实例
  • tree

    • 修复 id 属性为长数字时的初始选中状态在某些情况存在异常的问题 #1115
  • slider

    • 新增 done 属性,用于值完成选中时触发的回调,与 change 不同的是滑块拖动过程中不会触发 # I3PZBT
    • 新增 对绑定元素的 lay-options 属性识别,可与渲染方法的 options 属性合并
    • 优化 elem 属性,可传入 class 选择器同时绑定多个实例
    • 修复 min 非 0 时调用 setValue 设置值结果异常的问题 # 1174/I6446N
  • rate

    • 新增 对绑定元素的 lay-options 属性识别,可与渲染方法的 options 属性合并
    • 优化 elem 属性,可传入 class 选择器同时绑定多个实例
    • 优化 部分代码存在的冗余逻辑 # 1169
  • code

    • 新增 preview 属性,用于开启 Code 预览功能
    • 新增 style/previewStyle/codeStyle 属性,用于设 Code 区域、预览区域的样式
    • 新增 text 属性,用于自定义默认文本
    • 新增 header 属性,用于是否开启 Code 区域的头部栏
    • 新增 layout 属性,用于设定开启预览时的标签排列方式
    • 新增 tools 属性,用于开启头部右侧区域工具栏(内置:全屏)
    • 新增 toolsEvent 属性,用于自定义工具栏事件
    • 新增 id 属性,设置实例的唯一索引,以便用于其他操作
    • 新增 className 属性,追加实例面板的 className以便对其自定义样式
    • 新增 done 属性,即执行 Code 预览后的回调函数
  • laytpl

    • 新增 模板局部自定义标签符功能,可在 laytpl(str, options) 的第二个参数中设置
  • util

    • 重构 util.fixbar 组件
      • 新增 bars 属性,用于定义任意数量的 bar 列表信息
      • 新增 default 属性,用于是否显示默认的 bar 列表
      • 新增 target 属性,用于定义插入 fixbar 节点的目标元素选择器(默认 body)
      • 新增 scroll 属性,用于设定 fixbar 最外层容器滚动条所在的元素,若不设置则取 target
      • 新增 duration 属性,用于设定 top bar 等动画时长
      • 新增 on 属性,用于定义列表的任意事件
      • 调整 showHeight 属性名称为 margin
    • 新增 util.openWin(options) 方法,用于打开浏览器新标签页

下载: layui-v2.8.0.zip


历史:2.8.0 预览版更新日志


2.7.x

前往查看 2.7.x 及更早前版本更新日志