SuperAPI AI 工具集

docs-lens-chart-settings

写作与研究

查看项目

更新于 10-15 21:37

技能介绍

用途:在文档中记录 Kibana Lens 图表设置时,对照 Kibana 源码核验标签、选项与渲染顺序,不凭猜测编写 UI 文案。

主要能力:从 i18n 的 defaultMessage 提取准确标签;按 JSX 顺序确定 UI 显示顺序;追踪条件渲染(图表类型、已选选项、维度数量);区分同一共享组件在不同图表下的参数差异。

代码位置:分区类图表(饼图、环形图、矩形树图、马赛克图、华夫图)位于 x-pack/platform/plugins/shared/lens/public/visualizations/partition/,含 partition_charts_meta.ts、toolbar/style_settings.tsx、titles_and_text_settings.tsx、appearance_settings.tsx、legend_settings.tsx;共享图例组件位于 shared_components/legend/,含 legend_settings.tsx、location/legend_location_settings.tsx、size/legend_size_settings.tsx。其他图表类型各有目录,如 xy/、heatmap/、gauge/、metric/、tagcloud/。

核验流程:先从 partition_charts_meta.ts 获取每图表配置,包括 toolbar.categoryOptions、numberOptions、emptySizeRatioOptions、isDisabled 及 legend 相关字段与 maxBuckets;再读 style_settings.tsx 与 titles_and_text_settings.tsx 追踪样式面板结构与各按钮组的显示条件;然后读图例包装组件,核对传入共享 LegendSettings 的 props(如 legendOptions、position、renderNestedLegendSwitch、allowedLegendStats、legendSize、shouldTruncate);再按 JSX 自上而下确定渲染顺序;最后逐项核对选项标签。

已知标签对应:Slice labels、Slice values、Width、Label truncation、Line limit、Show。分区图不显示 Position(需 location prop),Statistics 需 allowedLegendStats 长度大于 1,Show value 需恰好一个 Value/CurrentAndLastValue 类型统计。

限制:内容针对特定源码结构,随版本可能变化;华夫图的 Style 面板整体禁用、无 Slice labels 与 Slice values;颜色映射仅作用于第一个 Group by 维度。使用前应确认目标 Kibana 版本与源码分支一致。