SuperAPI AI 工具集

svg-visuals

设计与创作

查看项目

更新于 10-15 20:32

技能介绍

用途:在 Power BI PBIR 报表中,用 DAX 度量值返回 SVG 标记字符串,作为内联图形渲染到表格、矩阵、卡片、图像和切片器视觉对象中。度量值需以 data:image/svg+xml;utf8, 前缀开头,并将 dataCategory 设为 ImageUrl,以扩展度量形式存储在 reportExtensions.json。所有报表改动应通过 pbir 执行,pbir-format 技能仅提供只读模式参考;若 CLI 不可用或缺操作,应停止并报告。

主要能力:支持表格(tableEx)、矩阵(pivotTable)、图像(image,sourceType='imageData' + sourceField)、卡片(cardVisual 的 image 或 cardImage)、切片器(advancedSlicerVisual 每按钮一张图)。模板矩阵把项目符号、进度、药丸、迷你图、哑铃、发散、增量、图钉、仪表等模式映射到适配宿主,并提供 pbir visuals svg、pbir add gauge-card 命令。

使用方式:先查询模型获取真实值,将静态 SVG 写入 /tmp/mockup.svg 在浏览器预览并收集反馈,再转成 DAX。颜色必须用带 # 的十六进制(如 #2B7A78),不得用 %23 或颜色名。度量按 VAR 模式组织:CONFIG、归一化、SVG 元素、按文档顺序拼装;表/矩阵需 HASONEVALUE 防护小计行,用 <desc> 嵌入 FORMAT 值实现排序,用 viewBox 做响应式缩放,坐标取整。示例用 report.add_extension_measure(..., data_type="Text", data_category="ImageUrl", display_folder="SVG Charts") 创建,绑定扩展度量时 SourceRef 用 "Schema": "extension"。验证用 pbir validate "Report.Report" --all 与 pbir visuals bind "...Visual" --show。优先复用 UDF 库:PowerofBI.IBCS、DaxLib.SVG、PowerBI MacGuyver Toolbox;库安装在语义模型而非报表,可用 Tabular Editor CLI、Power BI MCP、connect-pbid 或 tmdl。

适用场景:表格/矩阵单元格内的迷你图、数据条、进度条、状态指示;卡片的 KPI 微图;无需交互的轻量图形。复杂交互可视化用 Deneb,统计图用 Python/R。

限制:SVG 无交互(无悬停、点击、提示),JavaScript 会被剥离;每个渲染单元格字符串上限 32K 字符;逐单元格有公式引擎成本;屏幕阅读器无法从 SVG URI 获取逐格数据;经典 card 不支持 SVG,需用 cardVisual。部分参考资料与实际命令细节暂未提供。