适用于数字标牌屏幕的数据表卡片

排行榜、时间表和价目表以格式化列、排名和高亮行的清晰表格形式出现，便于全场阅读。它可填满屏幕，居中显示，嵌入角落，作为单行或沿边缘的带状运行。你可以设置标题、列和行、高亮行及其颜色、领导带、排序顺序、每页行数和页面时间。

直播卡片

此卡由浏览器绘制，使用与播放器相同的代码，带示例数据。

类别：运营。标签：图表与仪表，数字与指标，办公室与工作场所。

布局

此核心卡适用于所有布局：全屏、居中、宽屏、角落、芯片、条带或任何自由矩形。

布局：全屏，居中，宽屏，角落，芯片，条带。表单：横向，纵向，方形，条带。

卡片布局、主题和发布。浏览卡片。

数据与隐私

此卡使用其配置的属性和实时卡数据。

属性

有关主题、背景、强调色和位置，请参见通用属性。

创建卡片时，在卡片的params中设置静态属性。其数据文档仅包含动态属性。嵌套行描述其父属性的内容。

静态属性

名称	类型	默认	数值和限制	描述
`title`	string	`""`	maxLength：`60`
`columns`	array		minItems：`1`；maxItems：`8`；必填
`columns[].key`	string		maxLength：`40`；必填
`columns[].label`	string		maxLength：`30`；必填
`columns[].align`	string	`"auto"`	`"auto"`, `"left"`, `"right"`, `"center"`	自动将数字靠右，文本靠左。
`columns[].format`	string	`"text"`	`"text"`, `"number"`, `"percent"`, `"currency"`, `"delta"`	百分比显示为带%符号的数字（12.5 -> 12.5%）。
`columns[].decimals`	整数，空值	`null`	最小值：`0`；最大值：`4`	空值：数字0，百分比1，货币2，增量1。
`columns[].width`	数字，空值	`null`	最小值：`0.2`；最大值：`10`	相对宽度；空值时列宽根据内容自动调整。
`columns[].priority`	整数，空值	`null`	最小值：`1`；最大值：`8`	小框保留哪些列，1 为首列。中心卡片超过三列时保留首列和其余中最重要的一列（排序列，否则优先级最低的数字列）。
`highlight`	整数，字符串，空值	`null`		排序后的行索引（0 为第一行），或第一列的值。
`striped`	boolean	`true`
`showRank`	boolean	`false`
`sortBy`	string	`""`	maxLength：`40`
`sortDesc`	boolean	`false`
`maxRows`	integer	`0`	最小值：`0`；最大值：`50`	每页行数；0显示尽可能多。页面按墙上时钟翻页。
`pageSeconds`	integer	`10`	最小值：`5`；最大值：`120`
`currency`	string	`"$"`	maxLength：`4`
`leader`	boolean	`false`		将第一行作为表格上方的领导带显示：其排名、名称大号显示及关键数据为主角。
`highlightTone`	字符串，空值	`null`	模式：`"^(#[0-9A-Fa-f]{6}([0-9A-Fa-f]{2})?\|base\|text\|muted\|faint\|accent\|accent2\|accent3\|onAccent\|surface\|surfaceStrong\|stroke\|highlight\|danger\|warning\|success\|cool\|warm)$"`	高亮行的调色板键或 #RRGGBB 颜色。null：主题的强调色。
`backgroundColor`	字符串，空值	`null`	模式：`"^#[0-9A-Fa-f]{6}([0-9A-Fa-f]{2})?$"`	用纯色 CSS 顺序覆盖卡片背景和底板。#RRGGBBAA 提供透明度。背景无则优先。
`textColor`	字符串，空值	`null`	模式：`"^#[0-9A-Fa-f]{6}([0-9A-Fa-f]{2})?$"`	覆盖主文本和次要文本颜色。强调色和语义状态色保持原有功能。

动态属性

名称	类型	默认	数值和限制	描述
`rows`	array		minItems：`1`；maxItems：`50`；必填

画布示例

将静态属性保存为 params.json 并创建卡片。结果中包含它的 crd_ ID。

{
  "theme": "neomustard",
  "columns": [
    {
      "key": "Example",
      "label": "Example"
    }
  ]
}

screenrig card create --type table --major 1 --file params.json

将此项目添加到播放列表页面的primitives中，并用该 ID 替换示例中的 ID。发布播放列表并分配屏幕。

{
  "id": "table",
  "primitive": "card",
  "card": "crd_01EXAMPLECARD000000000",
  "layout": "full",
  "content_fit": "fill"
}

写入实时数据

创建卡片后向其写入文档，之后替换该文档即可更新屏幕，无需重新发布。卡片会按其动态属性检查每次写入，并拒绝它不接受的文档。请使用与播放列表相同的项目。

将文档保存为card-data.json。CLI直接读取文档，无需包装：

{
  "rows": [
    {}
  ]
}

screenrig card data put crd_01EXAMPLECARD000000000 --file card-data.json

或直接调用 API。API 将相同文档包装在 document 字段中。智能体令牌已指定其项目，因此不发送项目头；若发送 ScreenRig-Project，必须与令牌项目匹配。通过环境提供 API 授权；详见 API 认证。

curl --request PUT "https://api.screenrig.ai/api/cards/crd_01EXAMPLECARD000000000/data" \
  --header "Authorization: Bearer $SCREENRIG_TOKEN" \
  --header "Content-Type: application/json" \
  --data '{"document":{"rows":[{}]}}'