Spreadsheet
從 Google Sheet、.csv 或 .xlsx 檔案讀取資料。
File - 從 Assets Window 拖入一個 Google Sheet、.csv 或 .xlsx 資產。
Excel Sheet - 從 .xlsx 資產中選擇一個 sheet（標籤頁）。
Column Title - 從電子表格中選擇一列。電子表格的第一行是保留的，用於填充此列表。
Spreadsheet Utility 只能從單列輸出資料。要使用同一資產的多個列，請為每個要輸出的列建立一個 Spreadsheet Utility。
Factorize - 當勾選時，一列文字可以轉換為值。例如，包含文字 Summer, Spring, Summer, Summer 的資料列可以轉換為值列表 1, 0, 1, 1。生成的列表按字母順序排列。
使用 Factorize 時，出於效能原因，資產也必須進行 ‘factorized’。在 Assets Window 中右鍵點擊資產並勾選 Factorize。
Remapping - 相對於資料中的最小和最大值重新對應數值。例如，如果你想建立一個長條圖，需要值 1 由高度為 300px 的矩形表示，你可以做到。
- None - 重新對應已停用。
- Area Range - 參見 Area Range。
- Number Range - 參見 Number Range。
- Number Range to Color - 參見 Number Range to Color。
如果資料中的最小值為 0，最大值為 10，並且有一個簡單的黑白漸層，值為 0 將輸出黑色，值為 10 將輸出白色，值為 5 將被重新對應為 50% 灰色。
Fixed Row - 當勾選時，將輸出 Row Index 中指定的行的內容（不包括標題行）。對於 Dynamic Rendering 很有用。
Row Index - 指定要輸出的行。值為 0 輸出電子表格的第 1 行（第 0 行保留給 Column Title）。
Row Offset - 對 Row Index 進行加減操作。
Use Every Nth Row - 僅取樣第一行然後每 N 行取樣一次，其中 N = 該值。
Row Count - 一個唯讀屬性，輸出選定列中的行數。
Column Count - 一個唯讀屬性，輸出資料中的列數。請注意，計數從第一列開始，到包含資料的最後一列結束。例如，如果透過 Google Sheet 匯入以下資料，將返回 Column Count 為 7（A-G 列）：
| A | B | C | D | E | F | G | H | I |
|---|---|---|---|---|---|---|---|---|
| 1 | 1 | 1 |
請注意，對於 .csv 檔案，這可能有所不同，因為空列仍可能被定義。例如，ColumnA,ColumnB,,,,, 中逗號後定義的列將包含在 Column Count 中。
Interpolate - 當勾選時，可以跨列混合資料。這需要 Column Title 被動畫化，可以透過將 Value Behaviour 連接到 Column Title 並對 Value 的 Value 屬性進行關鍵幀設定來實現。注意 - 值為 0 表示第一列。
Output Mode - 設定圖層的輸出：
- Data - 輸出原始資料。
- Sort Order (Ascending) - 按列資料從最小到最大值輸出排序順序。
- Sort Order (Descending) - 按列資料從最大到最小值輸出排序順序。
Sort Order 獲取列中的值並輸出它們的排序順序。例如，如果一個名為 Data 的列包含以下值，且 Output Mode 設定為 Sort Order (Ascending)，則 Spreadsheet 將輸出 Sort Order 中的值。
| Data | Sort Order |
|---|---|
| 56 | 3 |
| 3 | 0 |
| 17 | 1 |
| 40 | 2 |
如果 Output Mode 設定為 Sort Order (Descending)，Sort Order 將反轉。這對於諸如排行榜之類的應用很有用。
| Data | Sort Order |
|---|---|
| 56 | 0 |
| 3 | 3 |
| 17 | 2 |
| 40 | 1 |
然後，輸出可用於將 Duplicator 的 Shape Position Y 設定為在 Linear Distribution 中將長條圖的最大長條放在頂部，最小長條放在底部。然後可以使用 Remapping 將 Sort Order 轉換為有意義的位置值。例如，將 Sort Order 0, 1, 2 轉換為值 0, 50, 100。
- 建立一個 Text Shape、一個 Duplicator 和一個 Spreadsheet Utility。
- 建立一個包含標題為 ‘Name’ 的行以及下面列出多個名稱的
.csv檔案。
Name,Ringo,John,George,Paul- 將
.csv檔案匯入 Assets Window。 - 將
.csv拖入 Spreadsheet Utility 的 File 屬性。 - 在 Spreadsheet Utility 上將 Column Title 設定為 ‘Name’。
- 連接 textShape.id→duplicator.inputShapes。
- 將 Duplicator 的 Distribution 設定為 Linear。
- 將 Duplicator 的 Direction 設定為 Vertical。
- 將 Duplicator 的 Count 設定為 4。
- 連接 spreadsheet.id→textShape.string。
.csv 中的前 4 個名稱（不包括標題）將出現。對於多於或少於 4 個名稱，只需調整 Duplicator 上的 Count Y。
- 建立一個包含以下資料的
Google Sheet、.csv或.xlsx：
| Label | Value | Color |
|---|---|---|
| 235 | #00acee | |
| 1135 | #c13584 | |
| YouTube | 101 | #ff0000 |
| Vimeo | 2301 | #1ab7ea |
| TikTok | 764 | #69c9d0 |
- 如果使用 Google Sheet，確保 Link Sharing 設定為 Anyone with the link。
- 透過 Assets Window 匯入
Google Sheet、.csv或.xlsx。 - 將資產拖入 Viewport（這將建立一個 Spreadsheet Utility 並連接資產）。
- 在 Spreadsheet Utility 上，將 Column Title 設定為 Value。
- 建立一個 Rectangle。
- 連接 spreadsheet.id→rectangle.size.height。
- 選中 Rectangle，點擊 Shelf 中的 Duplicator 圖示。
- 將 Distribution 設定為 Linear。
- 將 Count 設定為 5。
此時你應該有 5 個矩形，每個矩形的高度按資料中 Value 列的每一行設定。為了將矩形固定到 ‘floor’，你可以使用 Align Behaviour。
- 建立一個 Align。
- 連接 align.id→rectangle.deformers。
- 在 Align Behaviour 上，將 Y 設定為 1。
如果資料包含很小/很大的值，你可能需要將值重新對應到更適合你的 Composition 的結果。
- 在 Spreadsheet Utility 上，將 Remapping 設定為 Number Range。
- 將 Source Minimum 設定為 0。
- 將 Source Maximum 設定為 2500。這兩個值大致包含資料的範圍。
- 將 Minimum 設定為 0。
- 將 Maximum 設定為 500。
資料中的值 0 現在將輸出為 0，而值 2500 將輸出為 500。在此範例中，我們有效地將所有值除以 2500/500 = 5，因此值 1000 將被重新對應為 200。
包含貨幣符號的欄位（例如 £ € $）將被識別為數值。例如，£123.45 在連接到數值屬性時將被解釋為 123.45。
如果值以 k、M 或 B 為後綴，則結果將分別乘以千、百萬或十億。例如，1.5k 在連接到數值屬性時將被轉換為 1500。