標籤元件- FineReport帮助文档 - 全面的报表使用教程和学习资料

1. 概述

報表伺服器版本	功能變更
11.0	-

「標籤元件」不支援填報應用，一般用在參數介面中給其他元件新增標籤。如下圖所示：

注：「標籤元件」在行動端參數介面不顯示，行動端識別的是元件的「標籤名稱」屬性，用元件的「標籤名稱」來實現標籤的功能。

將參數面板元件工具欄中的「標籤元件」拖入到參數面板中，如下圖所示：

元件有屬性、事件、行動端三個設定介面，包括了元件的一些標準設定項。

「標籤元件」的屬性設定介面如下圖所示：

各屬性設定項的詳細介紹如下：

分類	設定項	詳細介紹
基本	元件名稱	元件的名稱，手動輸入，通常與參數結合使用，如透過元件名獲取元件後將元件值傳遞給對應參數，預設為無。
	可用	元件是否可用，勾選後，填報時元件可編輯；不勾選，填報時元件灰化，不可編輯，預設勾選。
	可見	元件是否可見，勾選後，填報時頁面顯示元件；不勾選，填報時頁面不顯示元件，預設勾選。
座標·尺寸	元件位置	元件在參數面板中的位置，透過橫縱座標調整，座標會根據元件在參數面板中的位置自動顯示。
座標·尺寸	元件大小	元件的大小，透過寬度、高度調整，若透過拖曳調整，高寬度也隨着自動調整。
進階	元件值	元件初始化時的預設值，支援字串、欄位、公式，預設為空。字串：字元文字，例如：華北欄位：資料集欄位，資料集包括範本資料集和伺服器資料集。例如：資料集 ds1 的地區欄位公式：設計器支援的公式，例如： A1 儲存格的值
	自動換列	是否自動換列，勾選後，輸入內容會根據標籤大小自動換列；不勾選，不會自動換列，預設勾選。
	垂直置中	是否垂直置中，勾選後，輸入內容會在標籤內垂直置中；不勾選，不會垂直置中，預設勾選。
	字體大小	設定標籤的字體、格式、大小。注：行動端不支援設定字體類型、上標、下標的。

事件設定介面可以為元件新增事件實現某些效果，「標籤元件」支援的事件有初始化後、點選、值改變。如下圖所示：

注：初始化載入頁面時，標籤元件的渲染程式會進行一次指派，指派行為會觸發值改變事件。

因此「標籤元件」的「值改變」事件，除了在值改變時觸發，會在頁面載入時也觸發一次。

選擇一種事件類型後，即可新增事件內容，「標籤元件」支援的事件回应方式有 JavaScript 腳本、提交入庫、傳送郵件、匯出時間、行動端彈窗。如下圖所示：

選擇對應的事件回应方式新增即可，不同回应方式差別可參考：事件回应方式

行動端無可配置項。

注：「標籤元件」在行動端參數介面不顯示，行動端識別的是元件的「標籤名稱」屬性，用元件的「標籤名稱」來實現標籤的功能。

標籤元件的應用，可參見以下文檔：

應用場景	實際效果
場景描述：使用標籤元件，可以定義參數頁面需要輸入內容參考文檔： JS實現自訂按鈕快速給參數賦指定範圍值

應用場景

實際效果

場景描述：

使用標籤元件，可以定義參數頁面需要輸入內容

參考文檔：

JS實現自訂按鈕快速給參數賦指定範圍值