Power BI不支持直接渲染HTML字符串，仅能通过自定义视觉或Web Viewer（HTTPS地址）实现；HTML内容需过滤脚本、避免内联事件，且受长度与安全限制。
Power BI不支持直接渲染HTML字符串作为视觉对象
Power BI Desktop 里，你不能把一段 <div><h2>Hello</h2></div> 直接塞进卡片图或文本框里让它“执行”成页面。它会原样显示为纯文本，甚至可能被转义成 <div>。这不是bug，是安全限制——Power BI 的视觉对象运行在沙箱环境，不开放 DOM 操作或脚本执行能力。
<p>常见错误现象：<br>– 把 HTML 字符串拖到卡片图，看到的是源码而非渲染结果<br>– 在 DAX 中用 <code>CONCATENATEX 拼出 HTML，结果导出 PDF 或发布后仍是文本
– 试图在自定义视觉对象（Custom Visual）中用 innerHTML 注入内容，但被 Power BI 运行时拦截或清空
真正可行的路径只有两种：用官方支持的 Custom Visual 开发，或用 Power BI Embedded + 外部 HTML 页面
如果你需要动态、交互式 HTML 内容（比如带图表、按钮、折叠面板的说明页），必须走开发路线：
- 使用
powerbi-visuals-toolsCLI 初始化项目，基于 TypeScript + D3/React 构建视觉对象 - 在
visual.ts的update方法里，用d3.select(this.element).html(htmlString)渲染可信 HTML（注意：仅限静态结构，不能含<script>或内联事件如onclick） - 所有 HTML 必须经
DOMPurify.sanitize()过滤，否则提交到 AppSource 会被拒审 - 发布后，该视觉对象需由管理员在租户级启用，普通用户无法自行安装未签名的 .pbiviz 文件
如果只是展示静态富文本（如带颜色/列表的指标说明），推荐用现成的 HTML Content 自定义视觉（来自 Microsoft AppSource），但它只接受字段中的 HTML 字符串，且自动剥离 <script>、<iframe>、on* 属性。
立即学习“前端免费学习笔记（深入）”；
为什么不能用 Web Viewer 视觉加载本地 HTML 文件
Web Viewer 视觉只能加载 HTTPS 地址，不支持 file://、localhost 或相对路径（如 ./report.html）。常见错误场景：
将 Markdown 文章转换为微信公众号兼容的纯 HTML 格式。当用户要求"转成微信格式"、"生成公众号文章 HTML"、"排版到微信草稿箱"、"微信粘贴格式"时触发。输出带内联样式的纯 HTML，微信编辑器可直接渲染，无需额外适配。支持标题、段落、列表、粗体、行内代码、表格、引用块、代码块、配图的完整转换。
- 本地调试时填入
http://localhost:3000/chart.html—— 发布后因跨域或网络不可达而白屏 - 把 HTML 文件打包进 PBIX —— Power BI 不解析资源包内的 HTML，
Web Viewer根本找不到路径 - 用
data:text/html,Base64 方式内联 HTML —— Power BI 会拒绝加载，报错Navigation blocked: data URL
可行替代：把 HTML 部署到 Azure Blob Storage（开启静态网站）、SharePoint 文档库（允许匿名读取）或任何可公开访问的 HTTPS 域名下，再将该 URL 填入 Web Viewer 的 URL 字段。
数据驱动 HTML 渲染的关键限制与绕过方式
想让 HTML 内容随筛选器变化？例如点击某个产品，下方 HTML 显示该产品的技术参数表。这需要：
- 在数据模型中准备一列含 HTML 字符串的字段（如
[ProductDetailHTML]），内容为已转义的表格片段：<table><tr><td>CPU</td><td><strong>M2</strong></td></tr></table> - 确保该字段类型设为
Text，不是Whole Number或Date，否则 Power BI 会尝试格式化导致破坏结构 - 在
HTML Content视觉中绑定该字段；它会在每次视觉更新时重新解析 HTML，但不会执行 JS，也不会响应点击事件 - 避免在 HTML 中写
style="color: #ff0000"等内联样式——部分旧版 Power BI 客户端会过滤掉 style 属性；建议用class+ 外部 CSS（仅适用于 Custom Visual 开发）
复杂交互（比如点击 HTML 表格某行跳转到另一个报表页）做不到。Power BI 的 HTML 渲染层没有事件桥接机制，<a href="#" onclick="..."> 会被静默忽略。
最容易被忽略的一点：HTML 字符串字段如果来自 DirectQuery 或 Live Connection 模式，Power BI 可能截断超长内容（默认约 4000 字符），导致表格闭合标签丢失、渲染错乱。上线前务必用 LEN([field]) 检查长度，并在 SQL 或查询步骤中做截断+警告处理。
