如何编程配置SharePoint列表Choice column为选项添加颜色样式

目前Graph API、官方CSOM均未公开Choice列原生选项颜色的直接配置接口，但可以通过官方支持的列格式化能力实现和原生彩色选项完全一致的效果，无兼容性风险，具体实现方式如下：

• 第一步按你现有逻辑正常调用列创建接口完成Choice列创建，提前配置好所有需要的选项值，不需要额外处理颜色相关参数。
• 列创建完成后，通过更新列的接口给列配置自定义格式化规则，即可让每个选项渲染为对应颜色的标签样式，和参考效果完全一致。

核心格式化配置示例如下，直接替换里面的选项值和对应颜色类即可：

{
  "$schema": "https://developer.microsoft.com/json-schemas/sp/v2/column-formatting.schema.json",
  "elmType": "div",
  "style": {
    "padding": "4px 8px",
    "border-radius": "12px",
    "font-weight": "500",
    "display": "inline-flex",
    "align-items": "center"
  },
  "attributes": {
    "class": "=if(@currentField == '待处理','sp-css-backgroundColor-BgLightBlue sp-css-color-BlueText', if(@currentField == '进行中','sp-css-backgroundColor-BgLightGreen sp-css-color-GreenText', if(@currentField == '已阻塞','sp-css-backgroundColor-BgLightRed sp-css-color-RedText','sp-css-backgroundColor-BgLightGray sp-css-color-GrayText')))"
  },
  "txtContent": "@currentField"
}

上述代码中调用的class是SharePoint Online内置的官方主题样式类，不需要额外自定义CSS，渲染效果和系统原生彩色选项标签无视觉差异。

不同调用方式的配置入口：

• 使用Graph API时，在列更新的PATCH请求体中，将上述JSON作为columnFormatter属性的值传入即可。
• 使用CSOM时，给FieldChoice类型的列对象的CustomFormatter属性赋值上述JSON字符串，调用Update方法后提交上下文执行即可生效。
• 后续如果需要调整选项、修改对应颜色，直接更新该格式化配置即可，所有已有列表项会自动应用新样式，不需要重建列或修改已有项数据。

补充说明：SharePoint原生存储选项颜色的字段属于未公开内部属性，微软没有对外提供该属性的读写权限，直接调用非公开接口配置存在接口变更、配置失效的风险，上述列格式化方案属于官方公开支持的扩展能力，长期稳定可用。

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