导读:📑 Layui 2.8 《升级指南》
autoSort: true
时,更改 table.cache
未同步到 data
属性的问题 # 1247hide
表头属性时,执行完整重载可能出现的错位问题 # 1247/I6WX8Ypage
属性时底边框缺失问题 # 1228checkbox,radio
事件导致 table 组件不必要的异常提示问题 # I6Z5W5parseData
和 done
属性导致的渲染异常问题 # 1247treeTable.updateNode()
方法执行无效的问题 # 1247treeTable.expandAll()
方法隐藏所有节点导致统计栏消失的问题 # 1247obj.update()
方法导致树节点特征丢失的问题 # 1247/I6ZW2RtreeTable expandAll()
方法,支持展开所有节点 # 1247customName.rootId
属性为 data.rootPid
tab
层的样式异常问题 # I6YS0Fcheckbox
半选状态的样式 # I6YXVVshortcuts
属性机制,当点击快捷选项时自动确认 #I6YQU6<a>
标签的问题value
属性,按其顺序渲染初始值列表 # 1235Edge
图标copy
属性,用于开启代码复制功能图标onCopy
回调函数,用于自定义复制事件,而不触发内置的复制操作encode
属性,默认 true
,即开启对 code 的编码,且预览时强制开启table.reloadData()
未支持 page
属性的问题treeTable
点击排序后导致树形结构功能异常的问题 # 1232/I6YGU6layer
的 win10 风格并开启 icon
属性时信息框显示异常问题switch
在选中前后的尺寸差异 # I6YJO4colorpicker
点击颜色滑块时跳动到顶部的问题从 2.8.0-beta.1
到 rc.16
,经二十个预览版的持续迭代,Layui 终于迎来了:2.8.0
正式版。
同时,新域名下的 新文档站 也正式上线
,新版文档亦开源在 Github 以供协同维护。
正是开发者们依然坚持的热爱,促使了 Layui
这一朴实的归来。
layui.css
,以尽量减少请求#16baaa
在原有的墨绿基础上赋予了清新18
个字体图标xl
响应式支持layui.event()
方法,当组件事件中未设定 filter
时则可重复执行该事件 # 1135lay.options()
方法,以提供更直观的异常提示anim
属性的四个弹出方向的动画类,可实现边缘抽屉弹出,同时关闭时自动匹配对应的动画skin
属性可选值 layui-layer-win10
,可设置为 Windows 10 主题风格success
等回调的第三个参数:即当前弹层实例对象,以便操作内部方法photos
层的私有属性 hideFooter
,用于控制是否隐藏图片底部栏photos
层底部栏的「查看原图」功能photos
层对 lay-src
属性的支持prompt
层的 placeholder
属性 # 1136removeFocus
属性,用于是否移除弹层触发元素的焦点,避免按回车键时重复弹出 # 1143layer.closeLast(type)
方法,用于根据弹层类型关闭最近打开的层 # I66WI2<base target="_blank">
时,点击按钮导致的打开新页面 # 830 min/max
方法后再执行 restore
出现的异常问题 # 1135/I5QP66prompt
层的确认回调,支持输入空值 # 1143/I5UO7Nmsg/load/tips
层之外的弹出触发时的焦点,默认移除触发元素失去焦点 # 1143cellMaxWidth
属性和表头 maxWidth
属性,以设定列的最大宽度colResized
列拖拽宽度后的事件,并返回当前列的相关信息 # I3URH8/I3QDBIcolToggled
列筛选(显示或隐藏)后的事件,并返回当前列的相关信息 # I3URH8data: ["a","b","c"]
maxHeight
属性,用于定义表格的最大高度 # 1135/I5R6F6fieldTitle
表头属性,用于定义表头字段标题,该属性在筛选列和导出场景中优先级高于 title
属性 # 1170table.setRowChecked(id, opts)
方法,用于设置行选中状态 # I6CRL7table.getOptions(id)
方法,用于获取指定 id 对应的表格实例配置项 # 1135table.hideCol(id, cols)
方法,用于外部设置列的显示隐藏 # 1135/I5RUAJrowContextmenu
事件,用于显示行的右键菜单,需设置属性 defaultContextmenu:false
才生效 # 1188obj.setRowChecked(opts)
方法,用于设置当前行选中状态height
属性,可设置对父元素的高度自适应,如:height: '#父元素id-差值'
# 1111size: 'sm'
时,设置 align: 'center'
单元格内容未完全居中的问题 # 1107title
属性存在 html 标签时,头工具栏筛选栏列表中存在的异常问题 # 1107width
属性小于 minWidth
时,通过拖拽列调整宽度却以 minWidth
为起点宽度的问题 # 1107even:true
后,多行表头也会跟着变色的问题 # 1113table.exportFile()
方法导出任意数据时的某些异常问题 # 1135/I5S17Xedit
事件中返回的 obj.data
中的对应字段未同步更新值的问题 # I6A6SLscrollPos:'fixed'
失效的问题 # I68MBCalign: 'center'
表头属性时,打印时的合计行未能跟随居中的问题table.resize()
方法导致的在无数据或请求异常时的右侧固定列显示异常问题 # I6F72Uconfig
edit
事件的核心逻辑,新增返回 obj.reedit()
方法,可实现编辑内容校验不通过时重新显示编辑edit
事件的返回参数,新增返回 obj.oldValue
属性,用于获取字段修改前的旧值: #1107edit
事件的返回参数,新增返回 obj.getCol()
方法,用于获取当前列表头配置信息edit
开启后的对应单元格在鼠标 hover 时显示可编辑样式radio
事件,当返回数据中存在 LAY_DISABLED
状态时不触发templet
表头属性函数时返回的数据可包含 LAY_COL
特定字段lay-filter
属性值,则自动取实例 id
值,以减少冗余的属性设置page,limit
属性,当 page
未开启时,则默认不再向后端传递这两个参数 # I6G5BOLAY_INDEX
→ LAY_NUM
;下标: LAY_TABLE_INDEX
→ LAY_INDEX
form.render()
方法,若参数一传入的 jQuery 对象指向表单域容器,则渲染该表单域中的所有表单项select
选中时的样式select
开启搜索时,在清空搜索框文本后重置选中项(而非保留上次选中的值)checkbox、radio
对 title
属性值为 HTML 内容的转义checkbox
的内置风格,以支持半选效果 # 1224radio
的 checked
机制,可通过 form.val()
方法取消单选框的选中 # 1224select
子元素中以 <optgroup>
标签开头出现的异常问题 # I5MV17checkbox
的 lay-skin
属性默认为原始风格,标签风格值为 tag
checkbox
的私有属性 lay-text
,采用统一的 title
属性替代shortcuts
属性,用于开启面板左侧的快捷选择功能 # 1135fullPanel
属性,当 datetime
类型且非 range 模式,可开启日期和时间在同一面板操作 #1128theme
属性的多主题支持circle
圆圈高亮的内置主题autoConfirm
属性,用于开启选中目标值时即自动确认(默认 true) # 1138/I5T3GWshade
属性,用于开启弹出日期面板时的遮罩,其用法同 layer 的 shade 参数 # 1149rangeLinked
属性,用于是否开启日期范围选择时的区间联动标注模式,默认不开启 # 1172lay-options
属性识别,可覆盖 render 方法中的 options # 1128laydate.getInst()
方法,可返回指定 id
或绑定节点上的 lay-key
属性值对应的实例 # 1128laydate.unbind()
方法,可对目标元素解除当前实例的绑定 # 1128onConfirm/onNow/onClear
三个属性,分别用于确认、现在、清空三个事件的回调 # I65ZQ6min/max
后,年和月列表面板中对应的最小/大的年月值无法选中的问题 # 1128 I442FWmin/max
设定的范围内,仍能点击现在按钮的问题 # 573range
属性,并在浏览器缩放后面板出现换行的问题 # 1156cancel
和 close
回调,分别用于在取消选择和面板关闭后触发 # I3SJC7clickScope
属性,用于设置触发点击事件的菜单范围(如 all
即代表父子菜单均可触发事件) # 3NRJDshade
属性,用于开启弹出面板时的遮罩data
中 disabled
属性的支持,以禁用某一菜单项 # I6GSCDlay-options
属性识别,可与渲染方法的 options
属性合并dropdown.reloadData(id, options)
方法,用于仅重载数据或内容 # 1224dropdown.close(id)
方法,用于关闭对应的实例面板 # 1138templet
属性,支持函数写法click
回调函数,当其返回 return false
时,点击选项可不关闭面板 # I6DUMYlay-filter
属性值,则自动取实例 id
值,以减少冗余的属性设置show: true
时,ready
回调未执行的问题element.progress()
方法不支持更新分数值的问题 #622goto
方法,用于轮播跳转。可通过 var inst = carousel.render()
的实例获取 # 1128 I5LIWJlay-options
属性识别,可与渲染方法的 options
属性合并elem
属性,可传入 class
选择器同时绑定多个实例id
属性为长数字时的初始选中状态在某些情况存在异常的问题 #1115done
属性,用于值完成选中时触发的回调,与 change 不同的是滑块拖动过程中不会触发 # I3PZBTlay-options
属性识别,可与渲染方法的 options
属性合并elem
属性,可传入 class
选择器同时绑定多个实例min
非 0 时调用 setValue 设置值结果异常的问题 # 1174/I6446Nlay-options
属性识别,可与渲染方法的 options
属性合并elem
属性,可传入 class
选择器同时绑定多个实例preview
属性,用于开启 Code 预览功能style/previewStyle/codeStyle
属性,用于设 Code 区域、预览区域的样式text
属性,用于自定义默认文本header
属性,用于是否开启 Code 区域的头部栏layout
属性,用于设定开启预览时的标签排列方式tools
属性,用于开启头部右侧区域工具栏(内置:全屏)toolsEvent
属性,用于自定义工具栏事件id
属性,设置实例的唯一索引,以便用于其他操作className
属性,追加实例面板的 className,以便对其自定义样式done
属性,即执行 Code 预览后的回调函数laytpl(str, options)
的第二个参数中设置util.fixbar
组件
bars
属性,用于定义任意数量的 bar 列表信息default
属性,用于是否显示默认的 bar 列表target
属性,用于定义插入 fixbar 节点的目标元素选择器(默认 body)scroll
属性,用于设定 fixbar 最外层容器滚动条所在的元素,若不设置则取 targetduration
属性,用于设定 top bar 等动画时长on
属性,用于定义列表的任意事件showHeight
属性名称为 margin
util.openWin(options)
方法,用于打开浏览器新标签页前往查看 2.7.x
及更早前版本更新日志