元件聯動

一、 什麼是元件聯動？

元件聯動，簡而言之，就是讓頁面上的各個元件“學會溝通”。當一個元件的狀態或資料發生變化時，一個或多個其他關聯的元件能夠自動、實時地接收到這個變化，並做出相應的響應。 這使得您可以構建出動態、互動性強的儀表盤和資料看板。

二、 實現聯動的兩種核心方式

根據聯動場景的複雜度，您可以選擇以下兩種方式來實現元件聯動：

1. 直接訂閱 (元件屬性間聯動)：最常用、最直接的方式。一個元件直接“訂閱”另一個元件的特定資料。適用於簡單、點對點的聯動關係。
2. 透過頁面變數訂閱 (間接聯動)：更靈活、更強大的方式。透過一個公共的“資料中轉站”（頁面變數）來同步資料。適用於一個元件需要被多個元件訂閱，或多個元件共同影響一個元件的複雜場景。

1、元件之間直接訂閱

透過元件屬性間的直接繫結建立聯動關係。

以「工作項選擇器」為核心，構建迭代看板

在頁面頂部放置一個“迭代選擇器”，切換迭代時，下方的迭代詳情、需求列表、倒計時等資訊同步更新。

工作項卡片

• 配置：在卡片配置中，將資料來源設定為訂閱「工作項選擇器」的例項。
• 效果：選中迭代時，卡片自動展示該迭代的名稱、優先順序等詳細資訊。

工作項檢視

• 配置：
• 標題：訂閱「工作項選擇器」的“當前工作項名稱”。
• 篩選：新增篩選條件 關聯迭代 存在於 訂閱工作項選擇器。
• 效果：切換工作項時，檢視標題實時變化，並自動篩選、展示該迭代下的所有需求。

倒計時

• 配置：將“目標時間”設定為訂閱「工作項選擇器」的“迭代週期”欄位（或任意日期欄位）。
• 應用場景：倒計時根據所選迭代的結束日期，自動更新剩餘時間。

以「工作項檢視」為資料來源，動態展示進度

使用進度條直觀地展示一個檢視內（如當前迭代）工作項的完成比例。

進度條

• 配置：
• 分子(當前值)：訂閱「工作項檢視」的“已完成實際數量”
• 分母(目標值)：訂閱「工作項檢視」的“總數”。
• 效果：當檢視中工作項的狀態更新時，進度條自動重新整理，實時反映完成率。

以「團隊選擇器」為核心，按團隊篩選資料

透過切換團隊，快速檢視不同團隊的資源負載、工作項列表及相關統計圖表。

人力負荷

• 配置：在元件配置中，將“人員範圍”設定為訂閱「團隊選擇器」的“選中團隊”。
• 效果：切換團隊時，自動更新人員範圍及對應的資源負載資料。

工作項選擇器

• 配置：在工作項選擇器元件的“篩選”配置中，新增篩選條件（如 建立人），並將其值設定為訂閱「團隊選擇器」的“選中團隊”。
• 效果：切換團隊時，工作項選擇器元件展示的資料會自動過濾，僅顯示該團隊成員相關的工作項。

工作項檢視

• 配置：在工作項檢視元件的“篩選”配置中，新增篩選條件（如 建立人），並將其值設定為訂閱「團隊選擇器」的“選中團隊”。
• 效果：切換團隊時，工作項檢視元件展示的資料會自動過濾，僅顯示該團隊成員相關的工作項。

度量圖表

• 配置：在圖表元件的“篩選”配置中，新增篩選條件（如 建立人），並將其值設定為訂閱「團隊選擇器」的“選中團隊”。
• 效果：切換團隊時，圖表元件的資料來源會自動過濾，僅顯示該團隊成員相關的工作項。

以「篩選元件」為核心，實現頁面級統一篩選

在頁面上設定一個全域性篩選器，其條件可以同時應用到頁面內的多個資料元件上。

工作項選擇器

• 配置：在 工作項選擇器的配置中，篩選訂閱資料來源，並直接關聯到「篩選元件」。
• 效果：當使用者在篩選元件中更改條件時，工作項選擇器會同步重新整理資料。

工作項檢視

• 配置：在 工作項選擇器的配置中，篩選訂閱資料來源，並直接關聯到「篩選元件」。
• 效果：當使用者在篩選元件中更改條件時，工作項檢視會同步重新整理資料。

度量圖表

• 配置：在 工作項選擇器的配置中，篩選訂閱資料來源，並直接關聯到「篩選元件」。
• 效果：當使用者在篩選元件中更改條件時，度量圖表的會同步重新整理資料。

2、透過頁面變數訂閱

頁面變數作為資料中轉站，儲存可被多個元件讀寫的資料，實現元件間的間接聯動。

更多元件與頁面變數的通訊能力即將上線。