控件及參數(shù)
為了方便向表中插入記錄，插入表單支持設(shè)置控件類型及參數(shù)。本節(jié)將講述表單支持哪些控件及參數(shù)。
控件參數(shù)格式
選項(xiàng)與值之間以冒號:分割，多個控件參數(shù)之間以分號;分割。
例如上傳控件參數(shù)可能為 url:/app/admin/upload/file;exts:zip
控件類型及參數(shù)
文本框/數(shù)字文本框 input
| 參數(shù) | 說明 | 類型 | 默認(rèn)值 |
|---|---|---|---|
| lay-verify | 驗(yàn)證類型 required (必填項(xiàng)) phone（手機(jī)號）email（郵箱）url（網(wǎng)址）number（數(shù)字）date（日期）identity(身份證) | string | |
| placeholder | placeholder 占位符 | string | |
| disabled | 只讀 | int | 0 |
| autocomplete | 是否自動完成表單 | int | 1 |
| type | input類型 number 或 text | string | text |
| value | 初始值 | string |
示例 lay-verify:required;placeholder:請輸入
多行文本 textArea
| 參數(shù) | 說明 | 類型 | 默認(rèn)值 |
|---|---|---|---|
| lay-verify | 驗(yàn)證類型 required (必填項(xiàng)) phone（手機(jī)號）email（郵箱）url（網(wǎng)址）number（數(shù)字）date（日期）identity(身份證) | string | |
| placeholder | placeholder 占位符 | string | |
| disabled | 只讀 | int | 0 |
| value | 初始值 | string |
示例 lay-verify:required;placeholder:請輸入
下拉單選/下拉多選 Select
| 參數(shù) | 說明 | 類型 | 默認(rèn)值 |
|---|---|---|---|
| url | 獲取opitnons數(shù)據(jù)的地址 | string | |
| data | options數(shù)據(jù) | string | |
| value | 初始值 | string |
示例 data:0:正常,1:禁用,2:審核;value:2
如果下拉選擇是靜態(tài)的
則填寫格式類似為 data:0:正常,1:禁用,2:審核
如果下拉選擇是動態(tài)的
則填寫格式為 url:/app/admin/admin/select?format=select
返回格式參考 plugin/admin/app/controller/Crud.php formatSelect 方法
如果是字典數(shù)據(jù)
則填寫格式為 url:/app/admin/dict/get/{字典名}
樹形單選/樹形多選 treeSelect/treeSelectMulti
| 參數(shù) | 說明 | 類型 | 默認(rèn)值 |
|---|---|---|---|
| url | 返回樹形結(jié)構(gòu)的接口地址，格式參考表格底部說明 | string | |
| value | 初始值 | string |
示例 url:/app/admin/rule/select?format=tree
返回格式參考 plugin/admin/app/controller/Crud.php formatTree 方法
注意
由于pear-admin自帶的select下拉多選組件官方不再維護(hù)，webman-admin下拉選擇與樹形選擇使用的是xm-select組件，這兩種組件都不是layui官方組件。
日期選擇/日期時間選擇 datePicker
| 參數(shù) | 說明 | 類型 | 默認(rèn)值 |
|---|---|---|---|
| lay-verify | 驗(yàn)證類型 required (必填項(xiàng)) | string | |
| type | 選擇器類型可選值有 year month date time datetime | string | |
| format | 日期格式可選值有yyyy y MM M dd d HH H mm m ss s | string | |
| weekStart | 0周日 1周一 | int | |
| min | 最小值 如2017-1-1 | string | |
| max | 最大值 如2017-12-31 | string | |
| position | 定位方式 absolute fixed static | string | |
| zIndex | 層疊順序 | int | |
| showBottom | 是否顯示底部欄 | int | 1 |
| calendar | 是否顯示公歷節(jié)日 | int | 0 |
| value | 初始值 | string |
示例 format:date;max:2022-12-12
開關(guān) Switch
| 參數(shù) | 說明 | 類型 | 默認(rèn)值 |
|---|---|---|---|
| disabled | 只讀 | int | 0 |
| value | 初始值 0或1 | int | 0 |
| lay-text | 定義開關(guān)兩種狀態(tài)的文本示例lay-text:開啟|關(guān)閉 |
string |
示例 lay-text:開啟|關(guān)閉;value:1
上傳文件 upload
| 參數(shù) | 說明 | 類型 | 默認(rèn)值 |
|---|---|---|---|
| url | 上傳接口 | string | /app/admin/upload/file |
| accept | 指定允許上傳時校驗(yàn)的文件類型，可選值有 images(圖片) file(所有文件) video(視頻) audio(音頻) | string | |
| acceptMime | MIME 類型列表 如image/*(只顯示圖片文件) image/jpg, image/png(只顯示 jpg 和 png 文件) |
string | |
| exts | 允許上傳的文件后綴 如zip|rar|7z |
string | |
| field | 設(shè)定文件域的字段名 | string | __file__ |
| size | 設(shè)置文件最大可允許上傳的大小，單位 KB | int | |
| multiple(暫時不支持) | 是否允許多文件上傳 | int | 0 |
| value | 初始值 | string |
示例 url:/app/admin/upload/file;exts:zip
上傳圖片 uploadImage
| 參數(shù) | 說明 | 類型 | 默認(rèn)值 |
|---|---|---|---|
| url | 上傳接口 | string | /app/admin/upload/image |
| exts | 允許上傳的文件后綴 如zip|rar|7z |
string | |
| field | 設(shè)定文件域的字段名 | string | __file__ |
| size | 設(shè)置文件最大可允許上傳的大小，單位 KB | int | |
| multiple | 是否允許多文件上傳 | int | 0 |
| value | 初始值 | string |
示例 url:/app/admin/upload/avatar;size:2000
圖標(biāo) iconPicker
| 參數(shù) | 說明 | 類型 | 默認(rèn)值 |
|---|---|---|---|
| value | 初始值 | string |
示例 value:layui-icon-set
