1. 概述
1.1 預期效果
1.1.1 填報應用
填報報表中可以通過該控件錄入填報的數據，如下圖所示：
1.1.2 參數應用
參數面板處可以通過該控件過濾數據，如下圖所示：
1.2 實現思路
1.2.1 填報應用
添加控件後，在數據字典中設置選項，選擇數據。
1.2.2 參數應用
單選按鈕組控件綁定參數，通過參數過濾數據。
2. 填報應用
2.1 添加控件
2.1.1 步驟
新建普通報表，A2 單元格添加「文本控件」，A6 單元格、A8 單元格添加「日期控件」，A4 單元格添加「單選按鈕組控件」，展示列數設置爲 1 ，并爲控件所在單元格添加邊框。如下圖所示：
注：設置邊框的步驟請參見：單元格樣式 文檔中的 2.2.1 節内容。
單選按鈕組控件的數據字典設置如下圖所示：
2.1.2 單選按鈕組控件屬性簡介
各屬性設置項的詳細介紹如下表所示：
| 屬性 | 簡介 |
|---|---|
| 控件名 | 通常與參數結合使用 通過控件名可以獲得該控件，從而獲得控件值傳遞給對應參數 或者通過控件名獲得控件後通過 JS 設置控件的屬性 |
| 可用 | 勾選後，填報時可正常勾選填報内容 不勾選，填報時控件灰化，不可編輯 |
| 可見 | 勾選後，填報時控件可見 不勾選，填報時控件不可見 |
| 數據字典 | 通過數據字典來定義單選按鈕組實際值與顯示值，可參考文檔 數據字典 |
| 自适應 | 勾選後，列數多自動分行，完全展示按鈕 不勾選，可自定義設置展示列數，若展示不下将截斷展示 |
| 展示列數 | 設置單選按鈕組控件的展示列數，若展示不下将截斷展示 |
| 允許爲空 | 勾選後，允許控件爲空值 不勾選，填報校驗和提交時會提示：不能爲空 |
| 錯誤提示 | 用戶可自定義不允許爲空的提示信息 |
2.2 設置填報屬性
點擊「模板>報表填報屬性」，添加「内置SQL」，數據庫爲 FRDemo ，數據表爲「qingjia」，點擊「智能添加字段」，添加字段：name、type、startday、endday，并依次綁定單元格A2、A4、A6、A8，如下圖所示：
2.3 效果查看
保存模板，點擊「移動端預覽」，效果如本文 1.1.1 節所示。
注：支持 PC 端，效果圖此處不再展示。
3. 參數應用
3.1 模板準備
1）新建普通報表，新建 ds1 ，SQL 語句如下所示：
SELECT * FROM 銷量
2）點擊「模板>模板參數」，添加模板參數 p1 ，如下圖所示：
3.2 添加控件
3.2.1 步驟
在參數面板中添加「單選按鈕組控件」和「查詢控件」。如下圖所示：
3.2.2 注意事項
普通報表中，将參數面板控件工具欄中的「單選按鈕組控件」拖入到參數面板中即可。
決策報表中，先将參數界面拖入 body 界面，再将「單選按鈕組控件」拖入參數面板或 body 中即可，如下圖所示：
3.3 設置數據字典
3.3.1 步驟
選中單選按鈕組控件，控件名稱爲 p1 ，類型設置選擇「數據庫表」，數據庫爲「FRDemo」，數據庫表爲「銷量」，實際值和顯示值爲「地區」，如下圖所示：
3.3.2 屬性介紹
屬性：
各屬性設置項的詳細介紹如下：
| 屬性 | 簡介 |
|---|---|
| 控件名稱 | 通常與參數結合使用 通過控件名可以獲得該控件，從而獲得控件值傳遞給對應參數 或者通過控件名獲得控件後通過 JS 設置控件的屬性 |
| 可用 | 勾選後，預覽時可正常輸入文本信息 不勾選，預覽時控件灰化，不可編輯 |
| 可見 | 勾選後，預覽時控件可見 不勾選，預覽時控件不可見 |
| 标簽名稱 | 标簽名稱的作用就是用來彌補參數界面中标簽控件不支持的問題 |
| 控件值 | 控件默認顯示的值，詳情請參見：控件默認值 |
| 數據字典 | 數據字典可以定義下拉框實際值與顯示值，詳情請參見：數據字典 |
| 字體 | 文本框中輸入字體的大小 |
| 自适應 | 勾選後，列數多自動分行，完全展示按鈕 不勾選，可自定義設置展示列數，若展示不下将截斷展示 |
| 展示列數 | 設置單選按鈕組控件的展示列數 |
| 允許爲空 | 勾選後，可以不選擇任何值 不勾選，不選擇任何值時可自定義錯誤提示 |
| 錯誤提示 | 用戶可自定義不允許爲空的提示信息 |
| 控件位置 | 調整控件在參數面板中的位置 |
| 控件大小 | 調整控件的大小 |
移動端：
單選按鈕組控件，在移動端的展現，基本與PC端屬性一緻。
JAR 包在 2020-07-08 之後，且 App/HTML5 移動端展現插件在 V10.4.80 之後時，移動端支持設置控件的「最大顯示行數」。如下圖所示：
顯示邏輯如下表所示：
| 報表類型 | 控件位置 | 是否移動端重布局 | 顯示邏輯 |
|---|---|---|---|
| 普通報表 | 參數界面 | - | 根據控件選項擴展的行數，顯示區域不同： 1）若實際行數＜最大顯示行數，則組件區域的高度自動擴展，顯示全部選項，無多餘空白行，無滾動條 2）若實際行數≥最大顯示行數，則組件區域的高度先擴展，顯示最大顯示行數，其餘通過滾動條顯示 3）若最大顯示行數爲 0 ，組件區域由組件寬高比例決定，組件顯示行數由組件區域決定，顯示不下将出現滾動條 |
| 決策報表 | 參數界面 | - | |
| body 界面 | 勾選移動端重布局 | ||
| 未勾選移動端重布局 | 組件區域由組件寬高比例決定，高度無法自由擴展 組件顯示行數由組件區域決定，顯示不下将出現滾動條，不受最大顯示行數約束 |
3.4 設計界面添加表格
1）設計界面添加表格，其中 A2 單元格輸入公式：「$p1」，如下圖所示：
2）雙擊 B2 單元格，點擊過濾，設置「地區等於參數$p1」，如下圖所示：
3.5 效果查看
保存模板，點擊分頁預覽，效果如本文 1.1.2 節所示。
