SuperAPI AI 工具集

visualization-components

数据与分析

查看项目

更新于 10-16 00:01

技能介绍

用途:该技能让智能体协助用户使用 Looker 的 React 可视化组件,在客户端渲染 Looker 图表,构建自定义、高性能的数据体验。相比 iframe 嵌入,它没有 iframe 开销,渲染与交互更快,可深度控制图表配置,并能用自定义 React 组件替换默认图表,同时与 Looker 设计系统 @looker/components 集成。

主要能力:核心架构分为数据加载层与渲染层。DataProvider 提供已认证的 Looker SDK 实例;Query 负责取数,支持按 query(ID 或 slug)或 dashboard ID 获取;Visualization 依据查询返回的元数据渲染图表。支持的图表类型包括 line、area、scatter、sparkline、bar、column、pie、table(含标准与透视表)以及 single_value。

使用方式:先安装核心库及对等依赖:npm install @looker/visualizations @looker/components-data @looker/components @looker/sdk styled-components react react-dom。随后用 DataProvider 包裹应用,并用 Query 取数,例如按 query slug 或 dashboard ID 传入,再放置 Visualization。可通过 config 强制指定图表类型与系列颜色,也可用 chartTypeMap 将标准图表类型映射为自定义组件。国际化需在应用根节点调用一次 i18nInit,例如 i18nInit(frFR)。高级用法中,Query 会自动应用 sortByDateTime、nullValueZero、xAxisReversed 等转换;如需完全控制,可直接使用 @looker/components-data 的 useQueryData、useVisConfig 等 hooks。在 Looker Extension 内使用时,SDK 通常由 ExtensionContext 提供。

限制:可视化组件需要 ThemeProvider,若应用未提供会自动包裹 ComponentsProvider 默认主题;标准可视化组件目前不支持 date 类型的 measure;需确保 styled-components 版本为 ^5.3.1 或更高,以避免 context 不匹配。其他收费、平台与效果信息暂未提供。