卡片中的 Table 控制項

使用 Table 控制項來呈現表格資料，或是在列和行中最佳配置的任何結構化資訊。 表格是由三個不同的卡片元素組成：

• 資料表
• 表格資料列
• 表格儲存格

資料表

表格是表格資料列的最上層容器。 因此，它們具有許多屬性，可套用至所有表格儲存格及表格上資料列的外觀與版面配置。

元素屬性

Show grid lines – 指定是否應顯示格線。

Visible – 顯示或隱藏表格。 可以是 True 或 False。

Spacing – 控制此控制項與前一個控制項之間的間距。

Divider – 如果為「true」，會在控制項上方畫出分隔線。

Vertical alignment – 定義表格所有子內容的垂直對齊方式。

Horizontal alignment – 定義表格所有子內容的水平對齊方式。

Height – 指定表格應隨資料大小 (自動) 或放大以符合容器高度 (自動縮放)。

Grid style – 表格中所有表格儲存格的樣式提示。 允許的值：預設、強調、好、注意、警告、加強。

Repeat for every – 用於顯示此控制項多個執行個體的資料來源。 了解如何使用 repeat for every。

欄屬性

行數是在表格本身上定義的。 您可以從「行」索引標籤新增和移除行，其中每行都有下列屬性：

Width – 指定行的寬度。 若以數字表示，則 width 代表行相對於表格中其他行的重量。 若以字串表示，則 width 必須是「{{number}}px」格式 (例如，「50px」)，代表明確的畫素數目。

Horizontal alignment – 控制在預設情況下，行中所有儲存格內容的水平對齊方式。 若指定時，此值會覆寫表格等級的設定。 未指定時，水平對齊是在表格、列或儲存格等級上定義。

Vertical alignment – 控制在預設情況下，行中所有儲存格內容的垂直對齊方式。 若指定時，此值會覆寫表格等級的設定。 未指定時，垂直對齊是在表格、列或儲存格等級上定義。

表格列

表格卡片元素的直接子項目就是表格列。 它會將數個表格儲存格水平歸類在一起，並包含一些會套用至該列中所有項目的屬性：

Visible – 顯示或隱藏元素。 可以是 True 或 False。

Spacing – 控制此控制項與前一個控制項之間的間距。

Divider – 如果為「true」，會在控制項上方畫出分隔線。

Vertical alignment – 定義列中所有儲存格內容的垂直對齊方式。

Horizontal alignment – 定義列中所有儲存格內容的水平對齊方式。

Height – 指定表格列應隨資料大小 (自動) 或放大以符合容器高度 (自動縮放)。

Style – 列中所有表格儲存格的樣式提示。 允許的值：預設、強調、好、注意、警告、加強。

Repeat for every – 用來顯示子儲存格之多個執行個體的資料來源。 了解如何使用 repeat for every。

表格儲存格

表示資料表元素的一個列中的儲存格。 它可以包含任何獨立的卡片元素做為子項目，以及下列屬性：

Bleed – 決定控制項是否應滲出其上層的邊框間距。

Background image – 指定背景影像。 可接受的格式為 PNG、JPEG 和 GIF。

Minimum height – 用畫素指定表格儲存格的最小高度，例如「80px」。

Spacing – 控制此控制項與前一個控制項之間的間距。

Divider – 如果為「true」，會在控制項上方畫出分隔線。

Horizontal alignment – 定義表格所有子內容的水平對齊方式。

Vertical alignment – 定義儲存格內所有子卡片元素內容的垂直對齊方式。

Present right-to-left – 若啟用，則表格儲存格中的內容應從右至左呈現。

Height – 指定表格儲存格是否應隨資料大小 (「自動」) 或放大以符合容器高度 (「自動縮放」)。

Style – 表格儲存格背景的樣式提示。 允許的值：預設、強調、好、注意、警告、加強。