导读：📑 Layui 2.8 《升级指南》 · 📑 Layui 新版文档站上线初衷
cellExpandedMode 基础属性，用于设置所有单元格默认展开方式 # I7XW28 [8bd8415]cellExpandedWidth 基础属性，用于设置所有单元格默认展开后的宽度 [8bd8415]expandedMode 表头属性，用于设置当前表头单元格展开方式，优先级高于 cellExpandedMode [8bd8415]required 规则 [a00ecf2]verIncludeRequired 全局属性，因为会造成不必要的歧义 [a00ecf2]rangeLinked 属性后，done 函数第二个参数未能正确返回开始日期的问题 #I7XBOA/I7YCHW [4d9365e]rangeLinked 且 range 为数组时，当初始值格式不符而自动校正导致的开始日期表单赋值异常问题 [4d9365e]dataType 属性，用于定义服务端返回的数据类型 [58e675c]codeRender 函数，用于重新渲染 code，譬如代码高亮处理 # 1352highlighter 属性，用于指定语法高亮器，支持 hljs,prism,shiki 等流行库 # 1352lang 属性，用于指定语言类型 # 1352langMarker 属性，用于是否在代码域右上角显示语言类型 # 1352wordWrap 属性，用于设置文字是否自动换行 [ad5935c]tools 属性，进一步提升可扩展性 [ad5935c]dark 模式主题，与 vscode 保持一致 [ad5935c]lay.clipboard.writeText(options) 方法，用于写入剪切板（复制） [5a00d0a]layui-padding-* 和 layui-margin-* 内外边距样式类名 [5e0d71d]photos 的 toolbar 属性，用于开启图片旋转 放大 缩小 还原等头部工具栏 # 1339photos 的 属性名： hideFooter → footer，用于是否开启底部栏size 为 sm / lg 时的展开状态table.renderData() 方法执行了多余排序的问题 # 1358radio 列选中状态丢失的问题 # 1358data 模式下排序之后出现节点结构错乱的问题 # 1358/I7TXXLdata.cascade 属性，新增 none 可选值，即操作节点时不做任何联动 # 1358shortcuts.value 快捷选项的赋值属性，支持函数类型 # 1324expandedWidth 表头属性，用于设置单元格被展开后的宽度table.reload() 造成 window resize 事件重复绑定的问题 # I7RJWYcustomName 属性，用于自定义 data 属性中常用的字段名称resize 事件报错问题customName 属性，用于自定义 data 中常用的字段名称lay.style() 方法，用于向页面创建 style 样式lay.position() 方法，可让下拉弹出元素的定位更智能因 2.8.14 版本存在 layer 主题样式异常问题，2.8.14 已被跳过。
checkbox 时对应的文字显示异常问题 # I7LQNOtotalRow 属性在 table.reloadData() 数据重载时的支持 # I7R6VYtreeTable.addNodes() 增加节点导致当前节点选中状态丢失的问题 # I7Q6IPdata.title 属性对 HTML 的转义处理。若不转义，可通过 templet 属性实现 # I7Q6IVutil.toDateString() 转换日期格式字符组件，以提供更强大的占位符支持 # 1314util.fixbar() 组件因 default 属性在 IE8 出现的保留字报错问题input 数字输入框在前置后置结构中的样式 # I7KTQBscrollbar 属性禁用页面滚动条时，点击最大化再还原导致滚动条又重新出现的问题 # I7NTGXid 值与其他弹层索引值相同时，导致关闭弹层存在冲突问题 # I7PF0Oauto: false 时，打开文件选择框并点击取消后，导致文件上传失效的问题 # I7NU31tree.data.cascade 属性，用于设置复选的级联方式，默认 all # 1309children 信息 # 1309checked 属性赋值机制，若初始数据源存在该属性，才对其进行动态赋值spread 属性赋值机制，若初始数据源存在该属性，则展开和收缩时，自动对其更新状态值radio 标题模板中若存在图标，选中时该图标被强制更改的问题 # I7IERBinput 数字输入框的精度问题 # I7I7J2verIncludelRequired 属性名为 verIncludeRequired # 1305menu 标题项自定义图标在展开收缩后被强制更改的问题 # 1303/I7JAPUchecked 属性值进行同步的问题layui.js 在 IE 和 Safari 等「古董浏览器」存在一个正则零宽断言报错的问题 # I7HZCZ/I7I0TOinput 数字输入框组件，通过动态点缀 lay-affix="number" 属性开启input,textarea 禁用状态时的样式 # I7GN5Ztext 属性，用于自定义内部各类场景下的提示文本countdown 倒计时组件，采用 options 参数写法，但仍对旧版兼容countdown 的 date,now,clock,done 等属性countdown 的 clear,reload 等实例方法，用于清除和重置倒计时等操作input 获取焦点时的光环效果，以提升当前活动输入框的辨别度select 开启搜索时 value 的改动，由于存在若干不可控的影响colTool 事件，点击表头自定义元素触发，并返回当前列的相关信息，提升 table 的可玩性row,tool,checkbox,radio 事件返回的 dataCache 属性，可获得当前行缓存数据，包含特定字段unified 属性，用于选择多文件时是否统一上传，即只发送一次请求 # I6Z171layui.js,layer.js 部分代码细节 # 1285select 开启搜索时输入状态，将值转移到 placeholder，便于输入2.8.8 中取消table.setRowChecked() 方法，新增当前行选中背景色，便于与 hover 等活动背景色区分table.setRowChecked() 方法中的 selectedStyle 属性，因为没有实质意义hide 在数据异常的情况下可能出现的表头错位的问题 # 1281done 回调函数，新增参数 origin 用于区分重载和重新渲染数据 # 1281ignoreExport 表头属性，允许指定不排除哪些字段 # 1281view.expandAllDefault 属性，用于设置是否默认展开全部节点 # 1281done 回调中执行了 expandAll 展开全部导致死循环问题 # 1281treeTable.reload(id) 若 id 未匹配到对应实例时出现的报错问题 # 1281/I7CXLNtable.renderData(id) 方法，用于重新渲染数据，可搭配 table.cache 使用 # 1273table.hideCol(id, cols) 第二个参数为普通对象时的异常问题 # 1270/I7AAUNtable.getTrHtml() 方法 tr 节点代码中的 numbers 列信息错误问题table setRowChecked() 方法中标注当前选中行样式的判断逻辑 # 1273treeTable.expandAll() 展开全部之后节点的折叠状态没有记忆的问题 # 1273element.tabAdd() 方法，第二个参数中新增 change 属性支持，以支持添加即自动切换功能因 2.8.5 版本中存在一个 tab 删除时下标的异常问题，2.8.5 已被跳过。
verIncludelRequired 全局属性，用于设置验证规则中是否同时包含必填 # I737EWlay-skin ，当设置非内置风格时，不再强制显示为默认风格lay-unrow 属性的识别，点击该元素时，可阻止执行 row 行单击事件table.setRowChecked() 方法导致 checkbox,radio 事件失效的问题 # I73MLV/I76KBX/I78VI3table.setRowChecked() 方法，若未传 checked 属性，则自动对 checkbox 进行选中状态值切换row 事件机制，若目标元素为 checkbox,radio，则不触发 row 事件height 属性值自动撑满customName.icon 属性，用于自定义图标的属性名称 # 1260/I73BQUasync.format 回调函数，用于处理异步子节点数据，优先级高于 async.url # 1260treeTable.reloadAsyncNode(id, index) 方法，用于重载异步子节点 # 1260treeTable.getNodeById(id) 方法，用于获取节点信息集 # 1260treeTable.getNodesByFilter(id, filter, opts) 方法，用于获取符合过滤规则的节点信息集 # 1260isSimpleData 模式渲染后的默认数据排序异常问题 # 1260treeTable.checkStatus() 方法，可通过设置第二个参数，用于是否返回半选状态的数据 # 1260/I73JAWskin:'layui-layer-lan' 时，导致 btnAlign 属性无效的问题 # I73PD1theme 属性，当其为数组格式，且第一个成员为 hex 格式主色值，则第二个成员为辅色值 # 1265exts 属性对于图片类型时的 .svg 扩展名支持copy 属性开启时, 对 tools 属性的初始化配置 # I72QGOpreview: 'iframe' 时的 <iframe> 容器，以支持背景透明layui.debounce() 和 layui.throttle()，分别用于防抖和节流 # 1252checkbox 的标题模板支持，可在下一个兄弟元素中加上 lay-checkbox 绑定 # I72HSK/I6YDGTradio 经浏览器翻译成别的语言后出现的显示异常问题 # I6ZA12checkbox 的边距细节checkbox 标签风格的边框瑕疵 # I70OFErequired)的校验规则 # I72CTItool,checkbox,radio 事件的 obj.getCol() 方法，用于获取当前列的配置信息 # I72D2CignoreExport 表头属性，用于在表格导出时对该列进行忽略 # 1252showIcon 为 false 在某些操作之后出现图标的问题 # 1252sort 属性后出现的一些异常问题 # 1252hideOnClose 属性，用于关闭弹层时设置为隐藏，默认 false。须与 id 属性并用 # I72L74layer.min(index) 方法与最小化按钮事件效果不一致的问题 # I6ZD3R.data('config') 中id 并最小化后，再次点击事件时，重新还原弹层 # I5N0QPautoSort: 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 正式版。
同时，新域名下的 新文档站 也正式上线（导读：Layui 新版文档站上线初衷），新版文档亦开源在 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 及更早前版本更新日志