更新日志

• 

  2.2.5

  2018-01-03

  2018年的第一个新版本

  • 新增 table 的 templet 方法支持，即现在自定义模板可以采用方法的形式替代内容 #详见文档
  • 新增 table 的 text 参数，用于自定义各种默认提示文本
  • 新增 layui.factory(modName) 方法，用于获取模块对应的工厂，以便回收利用
  • 新增 layui.sessionData(table, settings) 方法，用于存储本地会话性数据
  • 新增用于定义按钮容器的 class 选择器：layui-btn-container
  • 新增用于定义流体按钮的 class 选择器：layui-btn-fluid
  • 优化 table 的分页栏，如果无数据则不显示
  • 优化 layer 的 prompt 层，初始赋值 value 时的光标会出现在最后（之前版本会在最前）
  • 优化 layui.event() 和 layui.onevent() 方法，处理自定义事件更加灵活
  • 优化 layui.router() 方法，新增返回拼接后的 href
  • 修复 table 的异步数据在 code 为非0时，未执行 done 回调的问题
  • 修复 element.tabChange() 方法的 this 指向问题
• 

  2.2.4

  2017-12-07

  该版本对之前存在的较多问题进行了一次清理，推荐升级。

  • 新增 form 的 name 为数组格式（ 如：name="arr[]" ）的支持
  • 修复 form 的 select/checkbox/radio 等元素设定 lay-verType="tips" 时的提示层定位问题
  • 修复 table 的自适配列宽可能引发的报错：Cannot read property 'defaultView' of null
  • 修复 table 中渲染已知数据时执行 reload 不会清除之前数据的问题
  • 修复 upload 的 number 在 size 未设定时无效的问题
  • 修复 upload 的 allDone 回调在 auto: false 时的异常问题
  • 修复 upload 在 IE11 下设定 exts 的某些异常提示问题
  • 鉴于大家对 table 在 2.2.0 中的边框线普遍反映太浅，特此加深，回归统一边框

  ---

  • 2.2.45 （2017-12-08 补充）：
  • 进一步优化 form 的 name 数组支持
  • 修复 2.2.4 对 table reload 造成错误影响的问题
• 

  2.2.3

  2017-11-27

  • 新增 upload 模块的 number 参数，用于设定同时允许上传的文件数量（默认不限制） #详见文档
  • 新增 util 模块的 util.toDateString(time, format) 方法，用于转化时间戳或日期对象为日期格式字符 #详见文档
  • 新增 util 模块的 util.digit(num, length) 方法，用于对数字前置补零，如：6 ==> 06 #详见文档
  • 修复 table 特殊情况出现的：'cssRules' of undefined 报错问题
  • 修复 table 无数据时，点击列头的 checkbox 和排序出现的报错问题
  • 修复 laydate 的 set 方法报错问题
  • 恢复 form 的 lay-filter 在 layui 2.2.0 之前的验证规则，即：值为空也会触发内置的验证规则。选填项由开发者通过自定义验证来把控。
• 

  2.2.2

  2017-11-17

  • 优化 table 的列宽自动适配算法
  • 修复 table 的重载后，分页总条数未更新的问题
  • 修复 table 的删除行后，再点击全选，导致 table.checkStatus() 返回的数据异常问题
  • 修复 table 的选择条数在 Firefox 浏览器下失效的问题
  • 修复 table 的表头在同样的列宽下，Chrome 下正常，Firefox 和 ie 低版本下却出现省略号的差异性问题
  • 修复 layDate 中选择 datetime 选择器的月份列表报错的问题（尽管之前的报错不影响正常使用）
  • 去除 h1/h2/h3 的 14px 的重置样式

  ---

  • 注意事项：
  • 转换静态表格，请务必确保 table.init() 方法的 limit 参数（默认：10）是与你服务端限定的数据条数一致
  • 覆盖升级后注意清除浏览器缓存
• 

  2.2.1

  2017-11-16

  • 新增 table 的基础参数：cellMinWidth，用于全局定义所有常规单元格的最小宽度（默认 60） #详见文档
  • 新增 table 的表头参数：minWidth，用于局部定义常规单元格的最小宽度（默认 60），优先级大于 cellMinWidth #详见文档
  • 优化 table 内容超出单元格宽度时的一些小细节
  • 优化 table 选中行样式
  • 修复 table 的 page 参数传入 laypage 对象时的各种问题。这次可以真正做到分页的各种自定义，官网示例 页面中也有相关演示
  • 修复 table 的表单元素模板在 lg 尺寸单元格中未垂直居中的问题（注意，sm 尺寸的表格不做相关兼容）
  • 修复 table 的查看更多的单元格弹层在自定义模板的情况下，无效的问题
  • 修复在 ie8 下路径计算异常导致的所有 layui 内置模块失效的严重 bug
  • 覆盖升级后注意清除浏览器缓存
• 

  2.2.0

  2017-11-15

  本次升级幅度较大，主要核心还是在 table 模块。无论是从代码，还是文档和示例的撰写上，都进行了大量调整。除此之外，form 以及其它的几项改进，也堪称良心之举，这应该是一次令人愉悦的更新吧。特别说明的是：原计划与 layuiAdmin 同时发布，由于会员群对 layui 2.2 的呼声太高，经投票最终还是决定先发布 layui 2.2。而 layuiAdmin 和 Fly社区模板3.0，都将陆续推出，请耐心等待！

  • table 改进

    • 新增列宽自动适应功能，允许列宽设置百分比甚至不填写，内部自动分配
    • 新增序号列支持（type:'numbers'） #详见文档
    • 新增表头的基础参数：type，用于定义列类型（normal/checkbox/space/numbers等）
    • 优化 page 参数，支持传入一个对象，里面可包含 laypage 组件所有支持的参数（jump、elem除外）
    • limit 改为默认 10
    • 自定义模板中，可通过 undefined 获得序号
    • 优化主题样式，风格更加清爽，进一步接近 layui 极简理念
    • 优化单元格编辑样式（之前编辑时的样式不大明显）
    • 修复单元格弹出的更多内容浮层的若干问题
    • 修复 表单元素（如：复选框/开关/单选框） 在数据表格单元格中的样式异常问题
    • 修复表格重载时的左右抖动问题

  • form 改进

    • 设定 lay-verify 时，不再强制必填，除非同时设定了 required，如：lay-verify="phone|required" （注：2.2.3 已取消）
    • 对表单元素新增 lay-verType="" 属性，用于定义异常提示层模式，可选值有：tips（吸附）、alert（对话框），msg（默认）#详见文档
    • 搜索选择框匹配到相应选项时，如果未选择相应项，则失去焦点时清空内容（这样做的目的，是为了确保 select 是 option元素中定义的 value，而不是 text）
    • 复选框禁用状态样式优化

  • 其它改进

    • carousel 轮播当只有一个条目时，不会再显示指示器
    • 导航条允许设置 lay-unselect 属性，点击指定导航菜单标题时，将不会出现选中效果
    • layui.extend() 方法支持拓展一个自定义路径的 js 模块（可加载远程文件）
    • 优化 layDate 组件范围选择样式
    • 修复 layui.data() 方法无法存储空字符的值的问题

  • 注意事项

    • 为了统一规范，定义按钮尺寸的 CSS 类：layui-btn-mini 改为 layui-btn-xs、layui-btn-small 改为 layui-btn-sm、layui-btn-big 改为 layui-btn-lg，升级版本时务必注意
    • 覆盖升级后，注意清理浏览器缓存
• 

  2.1.7

  2017-11-02

  • 新增 upload 组件的 allDone 回调，用于监听多文件上传完毕后的状态（如：总文件数、成功数、失败数）
  • 新增 progress 进度条的分数设定（如：1/3）
  • 修复 layDate 组件当前面板为 1 月时，上个月（12月）的最后一天显示为 30 的 bug
  • 修复 layDate 组件输入一个非法值再点击其它同类控件，未校验上一个控件日期是否非法的问题
  • 修复 progress 进度条的 lay-percent 设定百分比在某些情况下存在的 bug
  • 优化 badge 徽章默认样式
• 

  2.1.6

  2017-10-30

  • 新增 element.tab(options) 方法，用于绑定自定义 Tab 元素（即非 layui 自带的 tab 结构，#详见文档）
  • 新增 tab 选项卡删除的事件监听 (tabDelete)
  • 新增 laytpl 的忽略分隔符 {{! template !}}，用于忽略指定区域的模板解析
  • 新增用于替代 element.init 的 element.render() 方法，并增加了两个参数：type、filter，以便对元素进行局部初始化。#详见文档
  • 为了编码统一，element.init() 方法可用 element.render() 方法替代。但 init 方法仍会兼容。
  • 优化 util 模块的 util.timeAgo() 方法的返回字符
  • 优化二级导航的箭头高度在移动设备偏下的问题
  • 修复垂直导航的一级导航行高没居中的问题
  • 修复 table 在列宽足够的情况下点击列可能会弹出 tips 的问题 #68
• 

  2.1.5

  2017-09-20

  本次更新内容较少，主要对一些细节进行优化。

  • 优化按钮样式，默认不再有 0.9 的透明度，因为这样看上去会更鲜艳些
  • 优化 carousel 轮播逻辑，以使条目切换的衔接动画更加自然些
  • 修复 carousel 模块的轮播在切换浏览器窗口后，出现空白 loading 的问题
  • 修复 input/textarea 等表单元素在搜狗浏览器下的 placeholder 行高问题
  • 修复 select 搜索框在 ios 设备和 safari 下无法输入的问题
  • 解决 后台布局 中滑动顶部最右导航，引发水平滚动条的不良体验问题（需向 body 加入一段样式，#详见文档 ）
• 

  2.1.4

  2017-09-15

  • 优化原始按钮行高偏下问题
  • 优化 table 多级表头并加强，使其真正做到无限级，且功能稳定。#见示例
  • 修复 table 如果有一页空数据，导致所有分页都显示为空数据的问题
  • 修复 table 的多级表头设定 checkbox 列后的异常问题
  • 修复 table 的多级表头如果组合列后面还有列，表格主体与表头未对应上的问题
  • 修复 table 中设置了 response 的 dataName，点击排序执行 table.reload() 方法后，无数据的问题
  • 修复 layDate 在 requirejs 下使用的报错问题
  • 如果 layDate 在 requirejs 下使用，需要通过 laydate.path = "" 来设定 laydate.js 所在目录 #见文档
• 

  2.1.3

  2017-09-13

  2.0 发布已经过去三周了，相比功能的继续丰富，也许更重要的是稳定，我们深知这一点。所以请尝试从“layui新版本存在许多问题”的错觉中清醒，事实上，当你真正适应了这一切，你会对 layui 有一个全新的认知。而今天更新的 2.1.3 主要还是力求稳定，但在下一个较大版本（2.2.0），你将会看到如你所愿的改进，也是社区呼声最高的存在，想象一下吧！

  • 优化 内置动画，以避免在 Chrome 最新版(61.0.3163.79) 中出现的各种奇异现象
  • 优化 layDate 的时间选择器（time）的范围选择体验，不再校验“结束时间超出开始时间”，以支持跨越凌晨的情况
  • 优化 layDate 的控件关闭，以避免focus事件下出现的未关闭上一个控件的问题
  • 优化 table 在行数据未填充满表格高度时，固定列仍然100%高度所形成的不雅感
  • 修复 layDate 中自定义无符号分割的日期格式（如yyyyMM、yyyyMMdd），二次选择后控件存在的异常问题
  • 修复 layDate 中的日期时间选择器（datetime）开启范围选择时，选择当天未校验“结束时间超出开始时间”的问题
  • 修复 table 中开启单元格编辑，在执行 update 方法后，值未同步编辑框的问题
  • 修复 table 中转换多级表头的静态表格有数据未展示的问题
  • 修复 layer 在最新版 Chrome（61.0.3163.79）下的遮罩层出现的奇异花屏现象
  • 修复 form 中设定 lay-verify="number" 不能验证负数和小数的问题
• 

  2.1.2

  2017-09-03

  感谢来自百度MIP团队的 前端小武 提供自动化测试，目前已正式邀请其成为 layui collaborator

  • 【layDate】修复 value 传入日期对象时，初始的input值异常问题
  • 【layDate】修复设置了min/max，年月列表的确定不可点击问题
  • 【table】优化 loading，改为显示在表格容器的正中位置
  • 【table】修复右侧固定列在部分设备（如手机/Mac）无效的问题
  • 【table】修复切换分页，未关闭上一个“查看全部”的提示层的问题
  • 【form】修复 input 输入框的 placeholder 在部分浏览器（如：Safari）下行高问题
  • 【底层】修复 layui.sort() 方法处理负数排序的问题 #57
• 

  2.1.1

  2017-09-01

  • 功能新增

    • [layDate] 对 mark 参数增加 0-0-date 支持，以标记每月的某天 #见文档
    • [table] 新增 initSort 参数，用于初始设置排序字段与状态 #见文档

  • 完善与优化

    • [layDate] 如果设置了 value，则默认给被绑定的元素（如 input）赋值

  • Bug Fixes

    • [layDate] 修复年列表的 disabled 小问题
    • [layPage] 修复在某些情况下，选择不同每页条数时，分页结构存在的小问题
    • [table] 修复 table sort 事件在执行 table.reload() 死循环的问题
    • [table] 修复多级表头开启复选框或设置左右固定列时的主体与表头未对齐问题
    • [upload] 修复多文件模式下，设置 size，出现重复请求的问题
• 

  2.1.0

  2017-08-30

  在过去一周对 2.0 的反馈收集中，我很惊诧地看到关于数据表格的多种吐槽。layui 向来以易用著称，但这次，大家普遍对 layui table 的态度却似乎并不是这样。这让我一度懊恼与不解，尽管可能的答案是：layui 的使用群体正在变得更加广泛。但我更多的是在反思。于是，在这个版本中，一半坚持原有的理念，一半妥协，默默并努力改造成我和你们都希望的样子。而这，仅仅只是开始…

  • 功能新增

    • [table] 新增 table.reload() 方法，以便对自动渲染的表格完成重载 #见文档
    • [table] 新增 height 最大化减去差值的自动换算功能（语法：full-差值），以让容器始终适应屏幕高度 #见文档
    • [table] 新增 response 参数，用于对返回的数据格式的自定义支持 #见文档
    • [table] 新增 request 参数，用于对分页请求的参数：page/limit的自定义名称支持 #见文档
    • [table] 新增sort事件，用于监听排序动作 #见文档
    • [upload] 开始支持直接在元素上配置基础参数
    • [upload] 回调中可通过 this.item 读取到当前触发上传的元素，一般用于 elem 绑定 class 的情况

  • 完善与优化

    • [响应式] 平板设备的临界值改为以iPad为准（768px）
    • [table] 去除选中的数据中的临时字段：LAY_CHECKED
    • [table] 优化局部代码
    • [tab选项卡] 点击 target="_blank" 类型的a标签时，不会对该项标记下标

  • Bug Fixes

    • [底层] 修复 layui.sort() 方法在个别特殊情况排序异常的问题
    • [table] 修复编辑单元格或删除行后，对列进行排序出现刚初始时的数据的Bug
    • [table] 修复在无数据的情况下开启 toolbar 且固定在右侧，出现重复的问题
    • [layDate] 修复点击时间选择器的标题区域，出现报错的问题
    • [layDate] 修复限制可选日期时，年列表和月列表存在的小问题
    • [tab选项卡] 修复执行添加tabs时，当出现下拉，再删除最后面几个tabs出现的Bug
• 

  2.0.2

  2017-08-24

  跟上个版本一样，重心还是放在 layDate 和 table 上

  • layDate 日期时间选择器

    • 增加开始日期超出结束日期时点击确定出现的提示
    • 修复回车事件影响其它元素（如 textarea）正常回车的失误性 bug
    • 修复：选择日期范围确定后，再重新打开并选择开始日期（却未点结束日期），再点击空白区域关闭，又重新打开，并选择更小一点的日期所出现的异常问题（卧槽，这个 bug 描述起来好累！你们读懂了吗？至少我都被自己说晕了。发现这个 bug 的同学心细如夸克）
    • 修复时间选择器在“360极(keng)速(die)浏览器”下因显示隐藏滚动条导致的样式异常问题

  • Table 表格

    • 增加对工具条模板的自定义 JS 脚本支持
    • 新增列“空隙”类型，以定义一个 15px 宽度无任何内容的列
    • 优化右固定列的左侧边框线、数据还未获取造成的分页落差感等细节问题
    • 去除在首列值为 null 或 undefined 时的自动加序号功能
    • 修复工具条，只有设置了 fixed 参数才会显示的 bug
    • 修复列单元格设置居中时，点击超出文本，未弹出查看更多的浮层的问题

  • 其它

    • 新增用于在不同设备下显示和隐藏的响应式公共类（见文档）
    • 优化导航样式
    • 修复富文本编辑器多次上传图片的覆盖问题
• 

  2.0.1

  2017-08-22

  尽管昨天发布了大版本，但是有 Bug 还是得速修

  • layDate 日期时间选择器

    • 日期时间选择器改为只能点确定关闭（以便选择时间）
    • 修复选择了当月的最后一天（比如29/31），再切换年月出现日期值超出的bug
    • 修复ready回调返回的月份值没有加1的问题

  • Table 表格

    • 修复Java端的异步接口未指定json类型，前端无法获取到数据的问题
    • 修复字符型数字排序异常的bug
    • 修复如果数字为0，单元格未显示0的bug
    • 修复勾选行，再删除行后，仍然可以获取该选中行数据的bug

  • 其它

    • 修复 Upload模块 正常返回了JSON，仍然抛出提示“请对上传接口返回有效JSON”的bug
    • 修复 富文本上传图片异常的BUG
    • 修复 layui.sort(obj, key, desc) 方法对字符型数字排序异常的bug
• 

  2.0.0

  2017-08-21

  里程碑式版本。核心机制未变，更多是对 1.x 的扩充和完善。它的意义并不只是那几项更新，而是自此开始，layui 进入一段重生之旅。
  因该版本改动较大，为避免代码冗余，特不兼容 1.x，请勿覆盖升级，你也可以阅读：1.x升2.0注意事项

  • Table 表格

    • 新增的全新模块，用于对表格进行一些列功能和动态数据操作
    • 支持固定表头、固定行、固定列左/列右
    • 支持拖拽改变列宽度
    • 支持多级表头
    • 支持大表格、小表格、默认表格的任意尺寸设定
    • 支持多种表格风格设定
    • 支持“Ajax接口获取”、“直接赋值数据”、“转化现有表格”三种初始化渲染方式
    • 支持单元格的自定义模板
    • 支持对表格重载（比如搜索、条件筛选等）
    • 内置checkbox复选框功能
    • 内置自定义工具条及相关操作功能
    • 内置分页功能
    • 内置字段排序功能
    • 内置单元格编辑功能
    • 内置显示单元格更多内容功能

  • Carousel 轮播

    • 新增的全新模块，用于处理页面轮播逻辑
    • 支持图片、文字列表等任意内容的切换
    • 支持普通轮播和全屏轮播（FullPage）的设定
    • 支持多种切换动画的设定
    • 支持是否自动切换、自动切换的时间间隔的设定
    • 支持初始开始的条目索引的设定
    • 支持箭头和指示器的风格和位置设定

  • Layout 布局

    • 新增栅格布局系统
    • 栅格采用12等分，内置移动设备、平板、桌面中等和大型屏幕的响应式处理
    • 栅格支持分栏间隔、列偏移、嵌套，流体布局等
    • 栅格最低能支持到ie8
    • 新增后台大框架布局现成方案

  • layDate 日期时间选择器

    • 全面重写，可作为独立组件（版本直接跃升为 5.0）
    • 依旧采用原生JavaScript编写，零依赖，可在layui中作为模块使用，也可作为独立组件使用
    • 支持单独显示年选择器、年月选择器、日期选择器、时间选择器、日期时间选择器
    • 支持双控件，用于选择年/年月/日期/时间/日期时间五种类型选择器的范围（可顺时、逆时）
    • 支持日期格式的自定义
    • 支持日期是否合法的自动校验
    • 支持有效日期范围的设定
    • 支持内置事件（可自定义）、外部事件、直接显示等多种调用方式
    • 支持中文版和国际版的语言设定
    • 支持开启公历节日和标记重要日期
    • 支持直接嵌套在页面的某个容器中
    • 支持底部按钮的任意顺序排版
    • 支持智能显示在最佳可视坐标
    • 支持回车快捷键选择
    • 支持多种内置主题的设定，支持自定义主题色，且可单独定制主题

  • Upload 上传

    • 全面重写
    • 可指定任意元素（如按钮、普通div等）来触发上传
    • 支持选择后自动上传和手工上传两种模式
    • 支持附加参数、支持自定义文件name等
    • 支持多文件上传（ie8/9除外）
    • 支持拖拽文件上传（ie8/9除外）
    • 支持文件大小限制，单位kb（ie8/9除外）
    • 支持图片上传前预览（ie8/9除外）
    • 支持文件跨域上传（ie8/9除外）

  • layPage 分页

    • 核心代码和接口重写
    • 新增“数据总数”、“每页条数”显示区域
    • 支持自定义排版
    • 新增count参数，用于得到数据总数，并剔除了pages参数（分页总数）
    • 新增limits参数，用于设定每页条数的选择项
    • 新增limit参数，用于设定每页条数的默认项
    • 优化跳页框在输入非数字时的校验
    • 总页数低于2时，仍然输出分页结构（前面版本不会显示）
    • 尾页文本默认显示为总页数
    • 跳页框如果输入的页码大于最大页数，则自动跳到最大页
    • 样式优化

  • Form 表单集合

    • select组件增加自动上下判断，用于显示在最佳可视区域
    • select组件允许出现“请选择”的空值选项
    • form.render(type, filter)方法增加第二个参数，用于指定某个区域进行局部渲染
    • 优化复选框样式，以更友好地用于非form场景中
    • form.on方法支持链式写法

  • Layer 弹层

    • 同步到最新的 layer v3.1.0
    • 增加maxHeight参数，用于设定弹层的最大高度
    • 对默认按钮颜色、Tips层、Prompt层、Tab层等进行了样式微调，以便更显大气，且更符合layui风格

  • Element 页面元素

    • 新增时间轴元素
    • 新增徽章元素
    • 新增动画CSS类文档
    • 导航UI细节优化，并新增三种主题色支持：墨绿/藏青/蓝
    • 导航支持加入图片
    • 分割线新增可支持的颜色：赤/橙/墨绿/藏青/蓝/黑/灰
    • Tab选项卡UI微调
    • element模块输出的接口由先前的函数改为对象

  • Util 工具集

    • 新增倒计时方法：util.countdown()
    • 新增用于得到“某个时间在当前时间的多久前”的方法：util.timeAgo()
    • [固定块] 新增 showHeight 参数，用于控制出现TOP按钮的滚动条高度临界值

  • 底层方法

    • 新增 layui.sort(obj, key, desc) 方法，用于将数组中的对象按某个成员重新对该数组排序
    • 改写layui.router()方法，以更好地解析location.hash的单页URL规则

  • 其它更改

    • 新增28个字体图标
    • 剔除全局滚动条样式
    • 获取内置的jQuery接口，可通过 var $ = layui.$; 得到，之前的 layui.jquery仍然可用
    • layui.css大量样式结构优化

  • Bug fixes

    • 修复select组件在没有任何option的情况下报错的问题
    • 修复导航多个排列在一起时，hover出现异常的问题
    • 修复layui.device()方法在Chrome设备模式无法识别ios环境的问题
    • 修复IE下，多次执行layui.use加载同一个模块时，控制台出现多条重复请求的问题（实际上不是真实请求）

  • 1.x 升 2.0 特别注意事项

    • layDate日期模块、layPage分页模块、Upload上传模块等等，均已完全重写，请按照最新文档修改
    • 获取 Form 模块接口，由之前的 var form = layui.form() 改为：var form = layui.form
    • 获取 Element 模块接口，由之前的 var element = layui.element() 改为：var element = layui.element
    • layui.all.js 的目录调整到跟 layui.js 的同级目录，如有使用到 layui.all.js，请注意修改路径
    • 由于改动较大，2.0其实并不兼容1.x，强烈不推荐覆盖升级。官网仍会保留 1.x 的存档，最好按需升级。
• 

  1.0.1 到 1.0.9

  2016-10-18 - 2017-02-28

  • 1.0.9
  • 1.0.8
  • 1.0.7/1.0.6/1.0.5
  • 1.0.4
  • 1.0.3
  • 1.0.2
  • 据可靠消息：1.0.1 版本的日志已被土卫六人劫走，并无任何踪迹
• 

  1.0.0

  2016-10-14

  首个正式版本出蛋
• 
  孵化