多選框 · ng-form

# 多選框一組備選項中進行多選。 checkbox多選框中除了基礎配置以外，主要的配置包含兩大類：屬性配置和數據配置。 ![checkbox1](https://img.kancloud.cn/d5/ec/d5ece4ecec421c1d2857a3dcc6e06b7d_2329x1406.png "checkbox1.png") ## 1、屬性配置屬性配置中包含了組件當前顯示的外觀及功能。當前主要包含： * 輸入提示 * 是否隱藏 * 是否禁用 ## 2、數據配置數據配置標示了當前下拉選擇器所能展示的數據。當前支持靜態數據、API接口、數據字典（需提前配置）三種輸入格式的接入。 ### 靜態數據靜態數據配置直接在節目上填寫即可。 ![checkbox2](https://img.kancloud.cn/6a/b6/6ab65af55aeaf9b18f38b0f49d17c09b_2343x1351.png "checkbox2.png") ### API接口 API接口通過axios請求獲取后端的接口數據后進行加載展示。示例(僅模板)： ``` { "list": [ { "type": "checkbox", "options": { "defaultValue": [ "1", "2" ], "placeholder": "請輸入", "dynamic": 1, "options": [], "remoteFunc": "https://netopt.net/api/bbs/api/hotUser", "dataPath": "data", "remoteValue": "userId", "remoteLabel": "username", "dictType": "", "hidden": false, "disabled": false, "linkage": false, "linkData": [] }, "label": "愛好", "labelWidth": -1, "width": "100%", "span": 24, "model": "checkbox_1679568230348", "key": "checkbox_1679568230348", "rules": [ { "required": false, "message": "必填項", "trigger": [ "blur" ] } ] } ], "config": { "labelPosition": "left", "labelWidth": 100, "size": "mini", "outputHidden": true, "hideRequiredMark": false, "syncLabelRequired": false, "customStyle": "" } } ``` ![checkbox3](https://img.kancloud.cn/0f/98/0f98c087c8a9c70a2f34613b429a1575_2338x1385.png "checkbox3.png") ***** **配置說明** **遠端方法**：遠程請求的接口地址。目前僅支持get請求。 **列表數據dataPath** 遠程請求后數據很多時候并不直接就是數組，在返回的數據結構中在某個路徑下才是我們需要的數據。此處的解析依賴object-path。舉例1: ``` 假設當前的數據返回結構為 { "msg":"操作成功", "code":0, "data":[ {"id": 1 , "name": "張三"}, {"id": 2 , "name": "李四"} ] } 則此時的dataPath 應該填寫為: data ``` 舉例2: ``` { "msg":"操作成功", "code":0, "data":{ list: [ {"id": 1 , "name": "張三"}, {"id": 2 , "name": "李四"} ], pageIndex: 1, pageSize: 2, totalCount: 78 } } 則此時的dataPath 應該填寫為: data.list ``` **值字段** 通過dataPath解析出來的數組單個值中標記value的字段。 **標簽字段** 通過dataPath解析出來的數組單個值中用來顯示的字段。 ### 數據字典數據字典需要提前配置。 ![checkbox4](https://img.kancloud.cn/94/b9/94b9ca5205cea39cf8fb98c782ee72c6_2318x1236.png "checkbox4.png")