參數 | 類型 | 說明 | 示例值 |
---|---|---|---|
field | String | 設定字段名。字段名的設定非常重要,且是表格數據列的唯一標識 | username |
title | String | 設定標題名稱 | 用戶名 |
width | Number/String | 設定列寬,若不填寫,則自動分配;若填寫,則支持值為:數字、百分比 請結合實際情況,對不同列做不同設定。 |
200 30% |
minWidth | Number | 局部定義當前常規單元格的最小寬度(默認:60),一般用於列寬自動分配的情況。其優先級高於基礎參數中的 cellMinWidth | 100 |
type | String | 設定列類型。可選值有:
|
任意一個可選值 |
LAY_CHECKED | Boolean | 是否全選狀態(默認:false)。必須復選框列開啟后才有效,如果設置 true,則表示復選框默認全部選中。 | true |
fixed | String | 固定列。可選值有:left(固定在左)、right(固定在右)。一旦設定,對應的列將會被固定在左或右,不隨滾動條而滾動。 注意:如果是固定在左,該列必須放在表頭最前面;如果是固定在右,該列必須放在表頭最后面。 |
left(同 true) right |
hide | Boolean | 是否初始隱藏列,默認:false。layui 2.4.0 新增 | true |
totalRow | Boolean/Object | 是否開啟該列的自動合計功能,默認:false。 當開啟時,則默認由前端自動合計當前行數據。從 layui 2.5.6 開始: 若接口直接返回了合計行數據,則優先讀取接口合計行數據,格式如下: codelayui.code
如上,在 totalRow 中返回所需統計的列字段名和值即可。 |
true |
totalRowText | String | 用於顯示自定義的合計文本。layui 2.4.0 新增 | "合計:" |
sort | Boolean | 是否允許排序(默認:false)。如果設置 true,則在對應的表頭顯示排序icon,從而對列開啟排序功能。 注意:不推薦對值同時存在“數字和普通字符”的列開啟排序,因為會進入字典序比對。比如:'賢心' > '2' > '100',這可能並不是你想要的結果,但字典序排列算法(ASCII碼比對)就是如此。 |
true |
unresize | Boolean | 是否禁用拖拽列寬(默認:false)。默認情況下會根據列類型(type)來決定是否禁用,如復選框列,會自動禁用。而其它普通列,默認允許拖拽列寬,當然你也可以設置 true 來禁用該功能。 | false |
edit | String | 單元格編輯類型(默認不開啟)目前只支持:text(輸入框) | text |
event | String | 自定義單元格點擊事件名,以便在 tool 事件中完成對該單元格的業務處理 | 任意字符 |
style | String | 自定義單元格樣式。即傳入 CSS 樣式 | color: #fff; |
align | String | 單元格排列方式。可選值有:left(默認)、center(居中)、right(居右) | center |
colspan | Number | 單元格所占列數(默認:1)。一般用於多級表頭 | 3 |
rowspan | Number | 單元格所占行數(默認:1)。一般用於多級表頭 | 2 |
templet | String | 自定義列模板,模板遵循 laytpl 語法。這是一個非常實用的功能,你可借助它實現邏輯處理,以及將原始數據轉化成其它格式,如時間戳轉化為日期字符等 | 詳見自定義模板 |
toolbar | String | 綁定工具條模板。可在每行對應的列中出現一些自定義的操作性按鈕 | 詳見行工具事件 |