导读:📑 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.rootPidtab 层的样式异常问题 # 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() 方法导致的在无数据或请求异常时的右侧固定列显示异常问题 # I6F72Uconfigedit 事件的核心逻辑,新增返回 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_INDEXform.render() 方法,若参数一传入的 jQuery 对象指向表单域容器,则渲染该表单域中的所有表单项select 选中时的样式select 开启搜索时,在清空搜索框文本后重置选中项(而非保留上次选中的值)checkbox、radio 对 title 属性值为 HTML 内容的转义checkbox 的内置风格,以支持半选效果 # 1224radio 的 checked 机制,可通过 form.val() 方法取消单选框的选中 # 1224select 子元素中以 <optgroup> 标签开头出现的异常问题 # I5MV17checkbox 的 lay-skin 属性默认为原始风格,标签风格值为 tagcheckbox 的私有属性 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 属性名称为 marginutil.openWin(options) 方法,用于打开浏览器新标签页前往查看 2.7.x 及更早前版本更新日志