1. 概述
1.1 版本
| 報表伺服器版本 | 功能變更 |
|---|---|
| 11.0 | - |
| 11.0.30 | 標籤名稱支援使用公式，詳情參見 2.1.2 節 |
1.2 應用場景
1.2.1 填報元件
填報報表中可以透過該元件錄入填報的資料，如下圖所示：
1.2.2 參數元件
參數面板處可以透過該元件過濾資料，如下圖所示：
1.3 如何新增
1.3.1 填報元件
被選儲存格後，點選右側屬性面板的「元件設定」，「選擇元件」處下拉選擇「單選按鈕組元件」，如下圖所示：
1.3.2 參數元件
將參數面板元件工具欄中的「單選按鈕組元件」拖入到參數面板中，如下圖所示：
1.4 使用說明
複選按鈕、單選按鈕組、複選按鈕組的差別：
複選按鈕僅有一個按鈕，按鈕兩個值 true 或者 false ,分別對應選擇與不選擇，適合是否選項的場景。
單選按鈕組可以有多個按鈕，每個按鈕對應一個值，在多個按鈕組成的按鈕組中選擇其中一個，適合多個選項選一個的場景。
複選按鈕組也可以有多個按鈕，每個按鈕對應一個值，在多個按鈕組成的按鈕組中可以選擇多個，適合多個選項選擇數可以大於 1 的場景。
如下圖所示：
2. 元件介紹
2.1 屬性
2.1.1 填報元件
「單選按鈕組元件」的屬性設定介面如下圖所示：
各屬性設定項的詳細介紹如下表所示：
注：「單選按鈕組元件」在填報應用時，可透過在儲存格中新增值的方式設定預設值，值可以為資料字典綁定的實際值，也可以為顯示值。
| 分類 | 設定項 | 詳細介紹 |
|---|---|---|
| 基本 | 元件名稱 | 元件的名稱，手動輸入，通常與參數結合使用，如透過元件名獲取元件後將元件值傳遞給對應參數，預設為無。 |
| 可 用 | 元件是否可用，勾選後，填報時元件可編輯；不勾選，填報時元件灰化，不可編輯，預設勾選。 | |
| 可 見 | 元件是否可見，勾選後，填報時頁面顯示元件；不勾選，填報時頁面不顯示元件，預設勾選。 | |
| 進階 | 資料字典 | 綁定元件的待選擇項，必須設定，否則元件不顯示，如何設定可參考：資料字典 注：不支援透過設定儲存格字體顏色來調整資料字典選項的字體顏色。 |
| 自適應 | 是否根據待選擇的項調整展示列數，勾選後，根據待選擇的項展示列數；不勾選，需自行設定展示列數，若展示不下將截斷展示，預設勾選。 | |
| 展示列數 | 不勾選「自適應」後出現的設定項，可自行設定展示列數，預設為 0。 | |
| 校驗 | 允許為空 | 是否允許元件不選擇項，勾選後，允許元件不選擇；不勾選，填報校驗和提交時會提示，預設勾選。 |
| 錯誤提示 | 不勾選「允許為空」時出現的設定項，可自訂提示資訊。預設情況下將顯示：不能為空 |
2.1.2 參數元件
「單選按鈕組元件」的屬性設定介面如下圖所示：
各屬性設定項的詳細介紹如下表所示：
| 分類 | 設定項 | 詳細介紹 | ||
|---|---|---|---|---|
| 基本 | 元件名稱 | 元件的名稱，手動輸入，通常與參數結合使用，如透過元件名獲取元件後將元件值傳遞給對應參數，預設為 radioGroup# 。 | ||
| 可 用 | 元件是否可用，勾選後，填報時元件可編輯；不勾選，填報時元件灰化，不可編輯，預設勾選。 | |||
| 可 見 | 元件是否可見，勾選後，填報時頁面顯示元件；不勾選，填報時頁面不顯示元件，預設勾選。 | |||
| 進階 | 標籤名稱 | 元件的標籤屬性是用在行動端的，行動端不支援參數面板上的「標籤元件」，識別的是普通元件的「標籤名稱」屬性，所以行動端可以用元件的標籤名稱來實現標籤 。 FineReport 11.0.30 及以上版本，標籤名稱支援使用公式。編輯框內輸入公式正文（等號開頭），自動計算公式結果作為最終標籤名稱。 注：使用 i18n 函式實現標籤名稱根據語言顯示時，多語言插件需更新至 V2.2.2 版本。若範本中使用的 key (範本內或平台內的 key )更新，需手動重新整理範本才可生效。 | ||
| 控 件 值 | 元件初始化時的預設值，可以為資料字典時綁定的實際值，也可以為顯示值。支援字串、欄位、公式，預設為空。 1）字串：字元文字，例如：華北
2）欄位：資料集欄位，資料集包括範本資料集和伺服器資料集。例如：資料集 ds1 的地區欄位
3）公式：設計器支援的公式，例如： A1 儲存格的值
| |||
| 資料字典 | 綁定元件的待選擇項，必須設定，否則元件不顯示，如何設定可參考：資料字典 | |||
| 字 體 | 顯示待選項的字體大小，預設為 12 。 注：此功能不支援行動端使用。 | |||
| 自適應 | 是否根據待選擇的項調整展示列數，勾選後，根據待選擇的項展示列數；不勾選，需自行設定展示列數，若展示不下將截斷展示，預設勾選。 | |||
| 展示列數 | 不勾選「自適應」後出現的設定項，可自行設定展示列數，預設為 0。 | |||
| 校驗 | 允許為空 | 是否允許元件不選擇項，勾選後，允許元件不選擇；不勾選，填報校驗和提交時會提示，預設勾選。 | ||
| 錯誤提示 | 不勾選「允許為空」時出現的設定項，可自訂提示資訊。預設情況下將顯示：不能為空 | |||
| 座標.尺寸 | 元件位置 | 元件在參數面板中的位置，透過橫縱座標調整，座標會根據元件在參數面板中的位置自動顯示。 | ||
| 元件大小 | 元件的大小，透過寬度、高度調整，若透過拖曳調整，高寬度也隨着自動調整。 | |||
2.2 事件
事件設定介面可以為元件新增事件實現某些效果，「單選按鈕組元件」支援的事件有初始化後、狀態改變。如下圖所示：
選擇一種事件類型後，即可新增事件內容，「單選按鈕元件」支援的事件回应方式有 JavaScript 腳本、提交入庫、傳送郵件。如下圖所示：
選擇對應的事件回应方式新增即可，不同回应方式差別可參考：事件回應方式
2.3 行動端
2.3.1 填報元件
行動端無可配置項。
2.3.2 參數元件
行動端設定介面如下圖所示：
行動端單選按鈕組元件樣式設定參見：［通用］單選按鈕組行動端按鈕組樣式
最大顯示行數邏輯如下表所示：
| 報表類型 | 元件位置 | 是否行動端重佈局 | 顯示邏輯 |
|---|---|---|---|
| 普通報表 | 參數介面 | - | 根據元件選項擴展的行數，顯示區域不同： 1）若實際行數＜最大顯示行數，則組件區域的高度自動擴展，顯示全部選項，無多餘空白行，無捲軸 2）若實際行數≥最大顯示行數，則組件區域的高度先擴展，顯示最大顯示行數，其餘透過捲軸顯示 3）若最大顯示行數為 0 ，組件區域由組件寬高比例決定，組件顯示行數由組件區域決定，顯示不下將出現捲軸 |
| 決策報表 | 參數介面 | - | |
| body 介面 | 勾選行動端重佈局 | ||
| 未勾選行動端重佈局 | 組件區域由組件寬高比例決定，高度無法自由擴展 組件顯示行數由組件區域決定，顯示不下將出現捲軸，不受最大顯示行數約束 |
3. 應用範例
單選按鈕組元件的應用，可參見以下文檔：
| 應用場景 | 實際效果 |
|---|---|
場景描述： 透過單選按鈕組建，可以實現對一日，一週，一個月資料進行查詢篩選 參考文檔： | |
| 場景描述： 參數介面或者填報元件單選按鈕組可以設定預設參數 參考文檔： |
|
| 場景描述： 使用單選按鈕可以控制範本的顯示內容為全部顯示或者部分顯示。 參考文檔： | |
| 場景描述： 使用無線電鈕可以選擇不同選項，實現顯示不同內容。 參考文檔： FVS按鈕組元件 | |
