input
数字输入框组件的特定属性 lay-precision
,用于设置数值精度 # 1375/I81SY4
input
数字输入框组件的失去焦点对值的有效范围约束 # 1375/I7KU6Vinput
数字输入框组件当值达到临界点时加减按钮的禁用视觉效果 # 1375input
数字输入框当表单验证失败时的边框颜色 # 1371lay-accordion
属性支持,用于开启手风琴,兼容旧版 lay-shrink="all"
# 1384photos
层的鼠标滚轮缩放功能 # I7ZAE8complete
属性,当数据接口请求完成后执行,无论成功还是失败均会触发 # 1379ignoreExport
表头属性值效果与文档不符的问题 # I86DBYtype: 'radio'
且为右侧固定列时,选择效果无效的问题 # 1406treeTable.removeNode()
在开启 data
模式时删除异常问题 # I7Z0AB/I82E2S
treeTable.setRowChecked()
方法未逐层展开上级节点的问题 # 1385/I84RUTtreeTable.addNodes()
新增根节点时出现的报错问题 # 1414unified: true
时的报错问题 # 1391reload
方法,可更好地进行完整重载 # 1391accordion
属性,开启手风琴效果(menu: 主容器设置 lay-accordion
属性) # 1397
rangeLinked
属性开启时,点击目标元素可重新渲染的问题 # 1391type
为 time,datetime
选择器时,「现在」按钮的禁用状态判断条件 # I828CDlimitTemplet
属性,用于自定义条目模板 # I80AHZskipText
属性,用于自定义跳页区域文本 # I80AHZcode
属性,用于设置原始 code 值,优先级高于目标元素中的内容 # 1391<hr>
全局样式优先级 # I86R6GcellExpandedMode
基础属性,用于设置所有单元格默认展开方式 # 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
等流行库 # 1352
lang
属性,用于指定语言类型 # 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/I7CXLN
table.renderData(id)
方法,用于重新渲染数据,可搭配 table.cache
使用 # 1273
table.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)
方法,用于获取符合过滤规则的节点信息集 # 1260
isSimpleData
模式渲染后的默认数据排序异常问题 # 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.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
正式版。
同时,新域名下的 新文档站 也正式上线(导读: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()
方法导致的在无数据或请求异常时的右侧固定列显示异常问题 # 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 模式,可开启日期和时间在同一面板操作 #1128
theme
属性的多主题支持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
即代表父子菜单均可触发事件) # 3NRJD
shade
属性,用于开启弹出面板时的遮罩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
及更早前版本更新日志