# 常用基礎控件 [TOC] > **配置方式：在`“頁面屬性”`->`“控件類型”`中選擇對應的控件類型**  ## 1. 下拉框 | 多選框 | 單選框 | 下拉多選 | 下拉搜索 > 字典用法：表單字段，通過配置系統字典或者表字典，實現下拉、Checkbox、Radio等效果。 > 支持模型： 系統字典 和表字典（通過數據庫表的配置）——不支持popup > 注：下拉搜索控件只支持表字典（不支持popup）  ### 1.1 數據字典 配置字典code（對應系統字典表的 字典編碼）如：bpm_status  字段code對應： 系統管理 -> 數據字典  演示：  ### 1.2 表字典  效果：實現通過表里面取數，下拉展示  ### 1.3 條件過濾 **支持自定義sql 增加查詢條件 過濾表數據** 配置方式，如圖所示在字典table上接表名后配置where[**where 一定要小寫**] 條件：  ## 2. 日期控件 | 時間控件 > 日期控件分為年月日和年月日時分秒控件 > `“年月日”`的數據庫類型對應`“date”`； `“年月日 時分秒”`的數據庫類型對應`“datetime”` `“時間”`的數據庫類型對應`“String”`  ## 3. Popup控件 _popup選擇框的使用依賴于Online報表_ （1）創建一個Online報表來提供彈出數據列表的數據集，如`“report_user”`  （2）選擇控件類型為popup彈出框 （3）字典Table、字典Code、字典Text項填寫對應的Online報表信息 ``` 字典Table: 填寫Online報表編碼，如：“report_user” 字典Code: 填寫Online報表中的字段名（多個逗號隔開）如：“username,realname” 字典Text: 填寫表單中字段名 （多個逗號隔開）如：“popup,popback” ```  （4）展示效果  ## 4. 用戶選擇 | 部門選擇 ### 4.1 配置 頁面屬性配置控件類型 選擇`“用戶選擇”`或`“部門選擇”` ### 4.2 高級用法-動態存儲/展示字段 - 使用場景 部門組件默認存儲部門ID,展示部門名稱， 用戶組件默認存儲用戶賬號，展示用戶名稱，現支持動態配置，指定存儲/展示的字段名。 - 配置 頁面屬性 -> 更多配置 點擊高級配置，可直接選擇是否多選、存儲字段、展示字段  - 備注：上述字段為部門/用戶實體的字段名或數據庫字段名都可以，可以只配置一個，配置的存儲字段需保證數據唯一性。 **目前只支持單表** ## 5. 分類字典樹 > 1.分類字典樹控件是基于 系統表`“分類字典”`設計的，為online提供一個樹控件，用于選擇分類字典的數據。 2.分類字典的數據維護見菜單【系統管理】-->【分類字典】 ### 5.1 配置方法一 > 只保存ID，列表及表單回顯數據需要系統翻譯，適用于小數據量，可保證當前表數據及分類字典表數據一致。 - online表單配置:  *此方案需要配置字典code的值，該值實際是分類字典的**類型編碼**，此處配置成B01即表示當前這個樹控件，只加載B01節點以下的數據* - 演示：  ### 5.2 配置方法二 > 保存ID和text ，列表及表單展示text，適用于大數據量，但是若分類字典表數據text被修改，當前表則難以保證數據一致性 - 頁面屬性-配置控件類型  - 校驗字段-配置字典  備注： 1、數據庫屬性配置兩個字段，字典code存儲樹id，字典Text存儲樹text 2、頁面屬性配置成分類字典樹，列表表單顯示，text為文本框，列表表單不顯示 3、字典code配置成分類字典的**類型編碼**，同一；字典text配置存儲樹text字段的名稱 - 演示，  ## 6. 自定義樹類型 * 1.頁面屬性-配置控件類型  * 2.校驗字段-配置字典  備注： 1、字典table 填寫樹控件對應的表名 { 例如：`sys_category` } 2、字典code填寫樹控件根節點的父ID的值，填`“0”`則為全部顯示 3、字典text填寫4個表字段的名稱，以逗號隔開，依次是：**ID列,父ID列,顯示列,是否有子節點列** { 例如：`id,pid,name,has_child`} > 字段順序解釋說明： > a. ID列和PID列用于記錄數據的父子關系，且ID列是該樹控件最終保存到數據庫的值 > b. 顯示列表示樹控件展示的數據， > c. 是否有子節點列是樹形表需要的特例列，詳細看 online表單樹形表單開發 ，該列為字符串類型系統默認1為是 0為否，不支持其他數據格式。 * 3.演示  ## 7. 下拉聯動組件 > 例如：省市區的三級聯動下拉選擇框 ### 7.1 表關系 **首先**，聯動組件的數據來源需要有相應的層級關系 ，如 ：新建一張表`sys_test_link`，數據如下： | id | pid | name | | --- | --- | --- | | 1 | | 中國 | | 2 | 1 | 山東省 | | 3 | 2 | 濟南市 | | 4 | 3 | 歷城區 | | 5 | 3 | 長青區 | | 6 | 2 | 青島市 | | 7 | 1 | 安徽省 | | 8 | 7 | 合肥市 | | 9 | 8 | 包河區 | | 10 | 8 | 廬陽區 | | 11 | 7 | 黃山市 | | ... | | | ### 7.2 online配置 新增字段— province，city，area 省-province字段上配置聯動組件，其他配置文本框即可  省-province字段的校驗字段 ----> 字典table --->配置json，格式如下： ``` { table: "sys_test_link", txt: "name", key: "id", linkField: "city,area", idField: "id", pidField: "pid", condition:"pid = '1'" } ```  配置描述： | 名稱 | 描述 | | --- | --- | | table | 數據庫表名 | | txt | 控件顯示的值 | | key | 控件需要存儲的值 | | linkField | 級聯組件的其他字段名稱，上例配置了市，區字段名 | | idField | 數據的標識 | | pidField | 上下級關系的表示字段 | | condition | 聯動組件 第一個下拉框的數據查詢條件 | 測試效果：  ## 8. 開關控件 > 用于場景：只有兩個選項且只能選一個 默認選項值： Y/N (即數據庫字段存儲為Y或N) 配置：  配置注意： - 控件類型選擇：開關 - 擴展參數：如果不想使用默認的選項值(Y/N)保存到數據庫，支持自定義,配置一個數組即可, 例如：配置數組 `[1,2]` 則第一個參數(1)對應是，第二個參數(2) 對應否 那么保存在數據庫的字段值為1/2 列表顯示：  單表/主表/一對一子表 表單效果展示：  一對多子表 表單效果展示：（勾選即Y）