MS List图库视图卡片背景色无法修改，寻求解决方案

架构老林

2026-7-4

MS List图库视图卡片背景色不生效的解决办法

排查与修复步骤

核对JSON的Schema地址
图库视图和列表/看板视图的JSON schema不通用，必须使用匹配的模板地址。图库视图的正确schema为：
```
https://developer.microsoft.com/json-schemas/sp/v2/tile-formatting.schema.json
```
用错schema会导致样式无法被正确解析，即便代码没有语法错误。
确认字段引用的准确性
即便使用了URL中的内部字段名，也要注意字段类型的匹配：
- 若为「选择」类型字段，要确保引用的是字段实际值，比如[$Category]或[$Category_Value]（可先在卡片中添加txtContent: "[$Category]"测试是否能正确显示类别值）。
- 文本类字段直接使用[$InternalFieldName]即可。

调整样式的作用元素
图库视图的卡片样式需要作用在最外层容器上，不能仅给内部元素添加背景。示例代码参考：

{
  "$schema": "https://developer.microsoft.com/json-schemas/sp/v2/tile-formatting.schema.json",
  "height": 180,
  "width": 250,
  "formatter": {
    "elmType": "div",
    "style": {
      "background-color": "=if([$TaskCategory] == '紧急任务', '#FFEBEB', '#E8F4F8')"
    },
    "children": [
      {
        "elmType": "div",
        "txtContent": "[$Title]",
        "style": {
          "padding": "12px",
          "font-size": "16px"
        }
      }
    ]
  }
}

把background-color直接写在卡片外层div的style中，确保覆盖整个卡片背景。