mirror of https://github.com/layui/layui
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.
23 KiB
23 KiB
title | toc |
---|---|
更新日志 | true |
更新日志
2.8.x
导读:📑 Layui 2.8 《升级指南》 · 📑 Layui 新版文档站上线初衷
2.8.4 2023-05-30
-
form
- 新增
verIncludelRequired
全局属性,用于设置验证规则中是否同时包含必填 # I737EW - 修复 checkbox 开关标题和半选图标未垂直居中的问题 # 1255
- 修复 checkbox 在初始设置半选时,点击复选框时图标未恢复成非半选状态的问题
- 修复 checkbox 被重新渲染时,标题模版未正确获取的问题 # 1257
- 修复 select 经浏览器翻译成别的语言后,点击选项出现的显示异常问题 # 1256
- 优化 checkbox 元素的
lay-skin
,当设置非内置风格时,不再强制显示为默认风格
- 新增
-
table
- 新增 对 table 内元素的
lay-unrow
属性的识别,点击该元素时,可阻止执行row
行单击事件 - 修复
table.setRowChecked()
方法导致checkbox,radio
事件失效的问题 # I73MLV/I76KBX/I78VI3 - 修复 打印功能在 Edge 中可能出现的闪退问题 # 1264
- 优化
table.setRowChecked()
方法,若未传checked
属性,则自动对checkbox
进行选中状态值切换 - 优化
row
事件机制,若目标元素为checkbox,radio
,则不触发row
事件 - 优化 外层容器的高度,不再设置一个固定值,内部元素将根据
height
属性值自动撑满 - 优化 底部边框问题
- 新增 对 table 内元素的
-
treeTable
- 新增 节点折叠状态记忆功能 # 1260/I777CJ
- 新增
customName.icon
属性,用于自定义图标的属性名称 # 1260/I73BQU - 新增
async.format
回调函数,用于处理异步子节点数据,优先级高于async.url
# 1260 - 新增
treeTable.reloadAsyncNode(id, index)
方法,用于重载异步子节点 # 1260 - 新增
treeTable.getNodeById(id)
方法,用于获取节点信息集 # 1260 - 新增
treeTable.getNodesByFilter(id, filter, opts)
方法,用于获取符合过滤规则的节点信息集 # 1260 - 修复
isSimpleData
模式渲染后的默认数据排序异常问题 # 1260 - 修复 展开全部节点排序失效的问题 # 1260/I73M2K
- 修复 折叠叶子节点时,图标没有变化的问题 # 1260
- 修复 节点选中状态判断异常问题 # 1260
- 优化
treeTable.checkStatus()
方法,可通过设置第二个参数,用于是否返回半选状态的数据 # 1260/I73JAW - 优化 重新排序和视图内表单初始化的调用逻辑 # 1260
- 优化 节点渲染方法 # 1260
-
layer
- 修复
skin:'layui-layer-lan'
时,导致btnAlign
属性无效的问题 # I73PD1
- 修复
-
laydate
- 优化
theme
属性,当其为数组格式,且第一个成员为hex
格式主色值,则第二个成员为辅色值 # 1265
- 优化
-
upload
- 新增
exts
属性对于图片类型时的.svg
扩展名支持
- 新增
-
code
- 优化
copy
属性开启时, 对tools
属性的初始化配置 # I72QGO - 优化
preview: 'iframe'
时的<iframe>
容器,以支持背景透明
- 优化
下载: layui-v2.8.4.zip
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
- 修复
showIcon
为false
在某些操作之后出现图标的问题 # 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 - 修复 执行重载并携带
parseData
和done
属性导致的渲染异常问题 # 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.1
到 rc.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()
方法,以提供更直观的异常提示
- 优化 css 的构建,将原先 layer/laydate/code 的 css 统一构建到
-
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_INDEX
→LAY_NUM
;下标:LAY_TABLE_INDEX
→LAY_INDEX
- 新增
-
treeTable new
- 新增「树形表格」组件。可视为 table 组件的树形结构的延伸
- 详细用法可参考文档(/docs/treeTable/)
-
form
- 新增 输入框的动静态点缀,可在前后缀添加图标等任意内容。其中动态点缀内置:清空、密码显隐功能
- 优化
form.render()
方法,若参数一传入的 jQuery 对象指向表单域容器,则渲染该表单域中的所有表单项 - 优化
select
选中时的样式 - 优化
select
开启搜索时,在清空搜索框文本后重置选中项(而非保留上次选中的值) - 优化
checkbox、radio
对title
属性值为 HTML 内容的转义 - 优化
checkbox
的内置风格,以支持半选效果 # 1224 - 优化
radio
的checked
机制,可通过form.val()
方法取消单选框的选中 # 1224 - 修复
select
子元素中以<optgroup>
标签开头出现的异常问题 # I5MV17 - 调整
checkbox
的lay-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
- 新增
cancel
和close
回调,分别用于在取消选择和面板关闭后触发 # I3SJC7 - 优化 事件处理机制,避免 document 的事件重复绑定
- 优化 组件选择块的尺寸(lg/md/sm/xs),以更好地应用于其他组件内(如 table)
- 修复 rgba 值在 input 框中修改时会自动变成 16 进制的问题 # I5QPZZ
- 新增
-
dropdown
- 新增
clickScope
属性,用于设置触发点击事件的菜单范围(如all
即代表父子菜单均可触发事件) # 3NRJD - 新增
shade
属性,用于开启弹出面板时的遮罩 - 新增
data
中disabled
属性的支持,以禁用某一菜单项 # 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
-
carousel
- 新增
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.7.x
前往查看 2.7.x
及更早前版本更新日志