求O365 SharePoint列表表头单元格橙底白字JSON格式化代码

需求说明 #

需要为SharePoint Online（O365）列表的表头单元格设置橙底白字样式，仅针对表头，不修改列数据单元格的样式。此前尝试修改列属性的格式化代码时出现构建错误，原因是未正确使用表头专属的配置项。

解决方案 #

使用列格式化中的headerFormatter属性单独定义表头样式，以下是符合官方规范的完整JSON代码：

{
  "$schema": "https://developer.microsoft.com/json-schemas/sp/v2/column-formatting.schema.json",
  "headerFormatter": {
    "elmType": "div",
    "style": {
      "background-color": "#FFA500",
      "color": "#FFFFFF",
      "padding": "8px",
      "font-weight": "bold",
      "width": "100%"
    },
    "txtContent": "@column.displayName"
  }
}

使用步骤 #

• 进入目标SharePoint列表的列表设置
• 找到需设置表头样式的列，点击列名进入列编辑页面
• 滚动至列格式化区域，点击格式化列
• 切换到高级模式，粘贴上述JSON代码后保存

关键说明 #

• headerFormatter是专门用于配置表头样式的属性，不会影响列数据单元格的样式
• 可通过修改background-color的十六进制值调整底色，color调整文字颜色
• txtContent绑定列的显示名称，确保表头文字正常显示

内容的提问来源于stack exchange，提问作者David