Power BI视觉对象API 5.1.0：如何用getFormattingModel定义数字字段合法范围？

在Power BI视觉对象API 5.1.0及以上版本中，旧版的validValues已被弃用，需通过**格式属性配置中的options.constraints**来定义数字输入字段的合法数值范围，具体实现方式如下：

• 核心配置逻辑：在构建数字类型的格式面板属性时，通过options.constraints对象设置min、max、step参数，以此限定数值的允许范围
• 代码示例：

// 构建格式面板的数字输入字段
{
    name: "borderWidth",
    displayName: "边框宽度",
    type: { numeric: true },
    defaultValue: 2,
    options: {
        constraints: {
            min: 0,    // 允许的最小值
            max: 10,   // 允许的最大值
            step: 0.5  // 数值调整的步长（可选，默认1）
        }
    }
}

参数说明 #

• min：可选，设置字段允许的最小数值，用户输入小于该值时会被自动修正为min值
• max：可选，设置字段允许的最大数值，用户输入大于该值时会被自动修正为max值
• step：可选，设置用户通过上下箭头调整数值时的步长，支持小数

你可以根据需求灵活组合这些参数，比如仅限制最大值、仅限制最小值，或者同时限定范围和步长。这种配置方式会直接在格式面板中生效，无需额外处理输入校验逻辑。

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