SuperAPI AI 工具集

visuals

数据与分析

查看项目

更新于 10-16 00:31

技能介绍

用途:在项目中加入数据可视化,包括图表/图形(如柱状图、折线图、饼图,基于 vega-lite)和数据网格(以结构化形式展示表格数据,支持排序、筛选、分页)。

主要能力与包:视觉组件由三个包提供。@microsoft/fabric-visuals 导出 VegaVisual 及 VisualizationSpec、VegaLiteConfig、VegaVisualProps 等类型;@microsoft/fabric-datagrid 导出 DataGrid 及 GridColumnDef、Row、CellValue、DataGridProps、DataGridTheme、SortConfig 等类型;@microsoft/fabric-visuals-core 导出 isDataTable、convertDataTableToRows 及设计令牌,并定义 DataTable 类型。

数据格式:图表与数据网格共用 DataTable 类型的 data prop,其中携带列元数据(displayName、format、semanticType),用于轴标题、表头、数字格式与提示。静态或内联数据可直接在 Vega-Lite spec 中写 data: { values: [...] } 并省略 data prop。data prop 还接受 Record<string, DataTable> 以引用多个数据集。

使用方式:图表传 Vega-Lite spec 与 DataTable;网格中 displayName 成为列头、format 作用于单元格。useCssTheme() 读取页面 --color-* 变量并随主题变化更新。DataGrid 的直接父容器须设置 overflow-auto。

交互:VegaVisual 与 DataGrid 均提供 onInteraction prop,在点击数据点或行时发出基于谓词的结构化事件;点击不同数据点发出新的 select(替换先前选择),再次点击同项或空白发出 clear。

限制:应优先使用上述方式;若无法满足需求,须先询问用户是否可用其他库,同意则用该库,否则用 HTML、CSS 与 JS/TS 从头构建,并确认颜色、标签等具体要求。收费、价格与平台支持等信息暂未提供。