如何在Power BI嵌入式报表中隐藏筛选器面板的动态筛选条件

云原生阿岚

2026-9-30

解决方案

你可以根据业务场景选择以下两种实现路径：

路径1：Power BI报表端预设置（无需修改嵌入代码，适配固定隐藏需求）

打开待嵌入的Power BI报表原件，在Power BI Desktop或服务端编辑视图中定位到需要传入动态值的筛选字段
右键对应字段选择隐藏，该字段默认不会出现在筛选器面板中，后续你通过嵌入代码传入的动态筛选规则依然可以正常生效，不受隐藏配置影响

注意：如果需要在部分场景显示该筛选器、仅嵌入MVC站点时隐藏，不要使用该方案，选择路径2

路径2：嵌入时通过Power BI JavaScript API配置隐藏（适配灵活切换场景）

如果你是通过官方Power BI JS SDK实现嵌入，直接在筛选器定义和嵌入配置中添加可见性控制参数即可：

定义动态筛选条件时，新增displaySettings配置项，将visible属性设为false，示例代码如下：

const dynamicFilter = {
  $schema: "http://powerbi.com/product/schema#basic",
  target: {
    table: "替换为你的业务表名",
    column: "替换为你的筛选字段名"
  },
  operator: "In",
  values: ["替换为你的动态筛选值"],
  // 核心配置：隐藏当前筛选器
  displaySettings: {
    visible: false
  }
}

将上述筛选器加入嵌入配置的filters数组中，如果需要完全隐藏整个筛选器面板，也可以在全局配置中追加设置，示例代码如下：

let embedConfig = {
  type: 'report',
  id: '替换为你的报表ID',
  embedUrl: '替换为你的报表嵌入URL',
  accessToken: '替换为你的访问令牌',
  filters: [dynamicFilter],
  // 可选配置：完全隐藏整个筛选器面板
  settings: {
    panes: {
      filters: {
        visible: false
      }
    }
  }
};