一.如果采用的是方法渲染,那么cols 是一个二维数组,表头参数设定在数组内
参数1:field
类型:String
说明:设定字段名。字段名的设定非常重要,且是表格数据列的唯一标识。
示例值:username
参数2:title
类型:String
说明:设定标题名称
示例值:用户名
参数3:width
类型:Number/String
说明:设定列宽,若不填写,则自动分配;若填写,则支持值为:数字、百分比请结合实际情况,对不同列做不同设定。
示例值:200、30%
参数4:minWidth
类型:Number
说明:局部定义当前常规单元格的最小宽度(默认:60),一般用于列宽自动分配的情况。其优先级高于基础参数中的 cellMinWidth
示例值:100
参数5:type
类型:String
说明:设定列类型。可选值有:
normal(常规列,无需设定)
checkbox(复选框列)
radio(单选框列,layui 2.4.0 新增)
numbers(序号列)
space(空列)
示例值:任意一个可选值
参数6:LAY_CHECKED
类型:Boolean
说明:是否全选状态(默认:false)。必须复选框列开启后才有效,如果设置 true,则表示复选框默认全部选中。
示例值:true
参数7:fixed
类型:String
说明:固定列。可选值有:left(固定在左)、right(固定在右)。一旦设定,对应的列将会被固定在左或右,不随滚动条而滚动。
注意:如果是固定在左,该列必须放在表头最前面;如果是固定在右,该列必须放在表头最后面。
示例值:left(同 true)、right
参数8:hide
类型:Boolean
说明:是否初始隐藏列,默认:false。(layui 2.4.0 新增)
示例值:true
参数9:totalRow
类型:Boolean
说明:是否开启该列的自动合计功能,默认:false。layui 2.4.0 新增
示例值:true
参数10:totalRowText
类型:String
说明:用于显示自定义的合计文本。layui 2.4.0 新增
示例值:"合计:"
参数11:sort
类型:Boolean
说明:是否允许排序(默认:false)。如果设置 true,则在对应的表头显示排序icon,从而对列开启排序功能。
注意:不推荐对值同时存在“数字和普通字符”的列开启排序,因为会进入字典序比对。比如:'贤心' > '2' > '100',这可能并不是你想要的结果,但字典序排列算法(ASCII码比对)就是如此。
示例值:true
参数12:unresize
类型:Boolean
说明:是否禁用拖拽列宽(默认:false)。默认情况下会根据列类型(type)来决定是否禁用,如复选框列,会自动禁用。而其它普通列,默认允许拖拽列宽,当然你也可以设置 true 来禁用该功能。
示例值:false
参数13:edit
类型:String
说明:单元格编辑类型(默认不开启)目前只支持:text(输入框)
示例值:text
参数14:event
类型:String
说明:自定义单元格点击事件名,以便在 tool 事件中完成对该单元格的业务处理
示例值:任意字符
参数15:style
类型:String
说明:自定义单元格样式。即传入 CSS 样式
示例值:background-color: #5FB878; color: #fff;
参数16:align
类型:String
说明:单元格排列方式。可