按鈕

功能說明

按鈕元件讓使用者透過單一次點擊，觸發一項或多項操作：對資料來源標籤設定數值，或切換儀表板顯示的頁面。適合需要用單一按鈕觸發多個標籤操作、切換分頁或執行複合動作的情境，例如以一顆按鈕同時對多個標籤送出設定值，或作為儀表板頁面之間的導覽入口。

樣式設定

圖形

選擇此按鈕元件顯示的圖形，並設定按鈕上標籤文字的字型樣式，讓按鈕的視覺呈現符合儀表板整體設計。

操作列表

設定按鈕觸發後要執行的操作型態。操作列表可以對一個或多個資料來源標籤設定下列動作：

• 設定常數值：將標籤寫入指定的固定數值
• 增加數值：將標籤目前的數值增加
• 減少數值：將標籤目前的數值減少
• 切換儀表板頁面：導覽至指定的儀表板分頁

透過操作列表，單一按鈕可同時設定多筆操作，一次觸發多個標籤動作或頁面切換。

觸發

設定使用者點擊按鈕後，操作列表中的動作要如何被執行。對會寫入數值的按鈕，可透過確認機制避免誤觸。

• 模式：
  • 預設值：點擊按鈕後立即依序執行操作列表中的所有動作，不再提示。
  • 彈出式：點擊按鈕後先顯示〔觸發操作〕提示框，需再按〔執行〕才會執行動作；按〔取消〕或關閉圖示則不執行。
• 需要提示確認（僅「彈出式」模式下顯示）：勾選後，在提示框按〔執行〕不會直接執行，而是展開〔確認觸發操作〕清單，逐條列出即將執行的動作（編號、動作名稱、對應的標籤與數值，或要切換的頁面編號），確認無誤後按〔確認〕才會執行。
• 再次確認（需先勾選「需要提示確認」才可設定）：在確認清單中加入「是的，我想執行這個操作」核取方塊，未勾選前〔確認〕按鈕維持停用狀態，適合用於重要或不可逆的寫入操作。

動作執行期間，按鈕上會顯示「處理中...」，此時再次點擊不會重複觸發；全部動作完成後顯示「成功：操作完成」。若其中一項動作失敗（例如找不到資料來源、寫入標籤失敗），執行會就此停止，未執行的後續動作不會繼續，並在按鈕上顯示該項的錯誤訊息。

基礎

背景顏色

設定元件的背景顏色。點擊顏色選擇器可開啟色彩面板，提供預設色彩選項、自訂色彩與透明度調整。

標題

• 啟用：勾選核取方塊以顯示標題
• 標題文字：輸入標題內容（最多 100 字元）
• 字型：從下拉選單選擇標題文字的字型，提供預設、系統字型（Arial、Calibri、Helvetica、Times New Roman 等）與中文字型（Microsoft JhengHei、Microsoft YaHei、SimSun 等）
• 大小寫：預設 / 大寫 / 小寫 / 字首大寫
• 尺寸：標題字型大小，範圍 10-128
• 字型顏色：設定標題文字顏色（預設 #333333）
• 對齊方式：靠左 / 置中 / 靠右

未啟用標題時，上述設定皆呈現停用狀態。

分隔線

• 啟用：勾選以顯示標題與內容之間的分隔線（預設已啟用）
• 顏色：預設半透明灰色 rgba(171, 171, 171, 0.36)
• 粗細：範圍 1-10

僅在啟用標題時可用。

外觀

緊湊模式

啟用後元件以較小邊距／較緊密排版顯示，節省畫面空間。

位置與尺寸

• X / Y：元件在畫布上的座標，最小值由系統定義，最大值依畫布大小與元件寬高動態計算
• 寬度 / 高度：各元件皆有系統定義的最小可用尺寸與預設值，實際數值由系統依畫布與元件內容動態計算

使用者限制

物件類別

選擇該元件的安全存取類別，只有具備相應權限的使用者才能檢視或操作：無（預設，不限制）／類別 A 到 L。

受保護時隱藏

勾選後，使用者無存取權限時完全隱藏此元件（而非僅停用）。僅在設定物件類別後可用。

Disabled

勾選後停用此元件的所有互動功能。僅在設定物件類別後可用。