Skip to content

yzsp-studio/mediakit-shared-suite / html

专门设计、生成和修改可直接在浏览器中打开的 HTML 页面或已发布的 html 链接。交付物以独立 .html 文件为主,可包含内联或本地 CSS、JavaScript,支持页面布局、视觉样式、交互效果、响应式适配、组件设计和内容展示。适用于静态网页、单页展示、活动页、原型页、HTML 模板及页面片段。不处理前后端工程、应用框架、服务端接口、数据库、用户系统、构建部署或运营数据。

references/chart/atlas.md

View on GitHub
# 图表图谱

图表选型与交互设计的统一入口。先确定读者要作出的判断,再按数据关系选择图形;下面的默认行为帮助收敛实现,用户指定的表达与用途优先。

## 常见场景的默认选择

| 用途与数据 | 默认阅读方式 |
| --- | --- |
| 最终截图、静态简报 | 重点、数字与必要说明直接呈现,交互只作辅助。 |
| 只有汇总值 | 精确读数;需要比较时增加差值或基准比较,不补造明细。 |
| 总览附带个体、某日或某周的明细 | 先展示总览,选中有明细的对象后展开,再次选择或返回可收起。用户需要常驻并排比较时可保留详情。 |
| 少量同尺度序列,需要追踪或持续比较 | 靠近曲线聚焦;需要留住参照时再提供固定基准。 |

用户只说“炫酷/高级”时,优先把相应读图动作做好。有明确模拟或教学目的时再考虑拖动数据、画预测;常规报告的观测值保持不变。图形、版面、配色和信息密度仍按题材与数据设计,交互机制不决定整页长相。

## 按需读取实现

- **常规读图、固定比较、总览查看某个对象的明细**:读 [reading-interactions.md](reading-interactions.md)。即使总览与明细用了两张图,也属于这一路径。
- **从同一批记录中筛选群体,在多个维度比较;或明确的教学实验**:再读 [experience-examples.md](experience-examples.md)。这份参考补充特殊任务的信息组织,不替代常规交互实现。

先定本任务的图形与布局,再按需要读取、嵌入交互实现。只有选定“总览查看明细”时才需要相应代码示例,不从示例页面反推任务设计。

## 图表类型

**先问"要表达什么关系"**(演进 / 流转 / 层级 / 对比 / 构成 / 趋势 / 分布),再选图表;**禁止先选图表再往里塞数据**,也禁止凭美观随机选型。
- 时间轴(Timeline):阶段演进、路线图、里程碑、事件序列
- 桑基图(Sankey):资源/流量/预算在多个环节间的分配与流转
- 流程图(Flowchart):有明确顺序与分支判断的步骤
- 树形图 / 组织架构图:层级归属、分类拆解、问题树
- 四象限 / 矩阵图:两个维度交叉的定位与分类(如重要性×紧急性)
- 对比表(Comparison Table):≥3 个对象在同一组维度上的并列对比
- 漏斗图(Funnel):逐级收窄的转化、筛选、决策过程
- 关系网络图(Network):多对多关系、生态位、利益相关方
- 甘特图(Gantt):任务在时间维度上的并行与依赖
- 堆叠条 / 百分比堆叠:构成占比随类别或时间的变化
- 折线图:连续变量的趋势与拐点
- 柱状图:离散类别的量级对比
- 散点图 / 气泡图:两至三个变量的相关性与分布
- 热力图:二维矩阵上的密度或强度分布
- 地图:地理维度的分布与流向
- 弦图 Chord:闭环多对多流转(贸易流、迁徙、供应链)。比 Sankey 更适合表达"没有起点终点、只有量级和流向"的关系。ECharts / D3 皆可。
- 力导向图 Force-directed:可交互动态关系网。用户能拖动节点、观察聚簇。适合社交网络、依赖图、生态位——静态关系使用上文的「关系网络图」;需要交互探索时使用力导向布局。
- 旭日图 Sunburst:层级 + 占比的组合表达,比 Treemap 更能读出「几层深」。适合分类学、目录结构、预算科目。
- Treemap 矩形树图:纯占比 + 层级,读者更关注面积对比而非层数时用它。
- 雷达图 Radar:维度 ≤ 6 且共享量纲(0-100 或相同单位)时用。>6 维必成蛛网 slop,改成小倍数条形图。
- 日历热力图 Calendar heatmap:时间 × 强度,GitHub 贡献格式。习惯追踪、事件密度、季节性。
- Bump chart:排名随时间变化。比折线更清晰"名次交换"的瞬间,体育、榜单、市场份额排位常用。
- Waffle chart 10×10:百分比人化表达。「100 人里有 23 人」比一个孤零零的 23% 更有力,适合社会议题、健康数据。
- Slope chart / Dumbbell:两时间点/两组别的前后对比。三列以上就退化成 bump 或折线。
- Small multiples 小倍数:同一图表在不同类别上重复。堆叠面积、多线折线超过 5 条时的默认答案——分成 5 张小图胜过一张挤爆的图。Tufte 反复强调过。
- Ridgeline / Joyplot:多类别分布对比,类似"山脊"堆叠。人口金字塔的现代版。
- Beeswarm:一维散点,避免重叠。分布 + 个体标注共存时比 boxplot 更亲切。
- Marimekko / Mosaic:宽度和高度都编码变量的堆叠——市场份额 × 品类销售额矩阵。信息密度极高但学习成本也高,慎用。
- Parallel coordinates 平行坐标:多维数据(>4 维)里找异常和聚簇。可交互 brush 时价值最大,静态图基本读不出东西。
- Stream graph:随时间变化的多类别占比,居中对称。适合"演进感"强的话题(音乐流派、话题热度),但读精确值不如堆叠面积。

**库选型**:默认 ECharts。它的**弱项是 force-directed 布局粗糙、chord 不够灵活、深度定制困难**——这三类改用 D3。统计图快速出图用 Observable Plot(声明式,20 行成图),手绘风格用 Rough.js。不用 Chart.js(扩展性差)和 Highcharts(商业授权)。

## 图表红线

以下几乎总是错,出现即降低产物可信度:

- **饼图分片 > 5**:读者无法比较角度。>5 类改横向条形(bar chart)按值降序。
- **甜甜圈饼图中间放大数字**:本质是"一个大数字 + 装饰环",中间数字直接放条形图旁边更诚实。
- **双 Y 轴 dual-axis**:几乎总是误导——两个量纲用视觉重合暗示相关性。改成上下两张对齐时间轴的图。
- **3D 饼图 / 3D 柱状图 / 3D 折线**:3D 扭曲比例,全是 slop。二维数据就用二维图。
- **词云 word cloud**:字号 ≠ 值,长词天然占更大面积。改条形图。
- **雷达图 > 6 维**:变成蛛网,任何两个方案叠上去都难以阅读。
- **面积图从非零基线开始**:面积图的语义就是「面积代表值」,切基线等于骗人。
- **堆叠折线**:折线的斜率语义在堆叠后失效,改堆叠面积或小倍数。
- **超过 7 种类别用颜色区分**:色盲/记忆容量都撑不住。合并成"其他"或改小倍数。
- **时间序列图缺 x 轴时间标签**:唯一豁免是正文内联的 sparkline。
- **柱状图坐标轴不从 0 开始**:视觉上放大微小差异,欺骗性极强(除非明确标注 axis break)。折线可以从非零起,柱状不行。
- **rainbow / jet 色板**:色觉不均匀,感知失真。用 viridis、cividis、magma(perceptually uniform)替换。
- **`tooltip.renderMode: 'richText'` 配 HTML formatter**:richText 指 ECharts 自有的 `rich` 语法、画进 canvas,`<b>` `<br/>` 会原样显示成字面文本,且不换行会把提示框拉成横跨整图的一行。要 HTML 就用默认 renderMode(想限制在图表内加 `confine: true` 即可,不要动 renderMode);要 richText 就把 `<br/>` 换成 `\n`、加粗改用 `rich` 样式段。`series.label` 与 `axisLabel` 永远是 canvas 绘制,同样只认 `\n`。

## 数据叙事模式

单张图表只是砖,叙事才是建筑。以下模式把图表编排成故事:

- **Scrollytelling**:滚动驱动图表变化,每一屏聚焦一个论点。工具选型和编排原则(一屏一论点、主图 pin、数据切换 tween、末态可读)见 [visual-techniques.md](../design/visual-techniques.md) 滚动叙事段。
- **Annotated chart**:在图上直接标"这里是转折点""这段数据缺失原因是 X",而不是把注解丢到图下 caption。The Economist、FT 是范式。annotation 用一根短线 + 4–8 字标签。
- **Reference band / event marker**:在时间序列上叠一层灰色 band 标"衰退期""疫情期""政策变化点"。历史/经济图表标配。
- **Linked views(brush + zoom)**:多图共享 selection——一张图 brush 出时间段,其他图同步 filter。**数据探索型看板**必备,静态报告用不上。
- **Chart-in-chart / detail-on-demand**:主图俯瞰,hover / click 出小图看局部细节。避免主图信息过载。
- **Sparkline inline**:文字段落里塞小图。"营收从 100 → 150 ↗ [小折线]",Tufte 原创。信息密度极高。
- **Comparison overlay**:多方案叠一张图 vs 分开小倍数——**默认走小倍数**,只有明确要读者比"交叉/交汇"时才叠。

## 图表 × 排版

图表不是孤立矩形,它属于版面:

- **坐标轴标签**:`tnum`(等宽数字)+ 数字右对齐。ECharts 默认没开。
- **图例位置**:能省则省——直接把系列名写在线的末端(label at end of line),读者眼睛不用来回跳。
- **色板与全站呼应**:图表颜色从 [SKILL.md](../../SKILL.md) 的整站 palette 派生(oklch 派生),不用 ECharts 默认 10 色轮盘(那套一眼 slop)。
- **网格线**:主网格 `#eeeeee` 或更淡,次网格不要。零轴用主文字色,其他坐标线 30–40% opacity。
- **数据密度优先**:Tufte data-ink ratio——能删掉的边框、背景、装饰性网格全删。
brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation).Stars: 322kUpdated Claude CodeCodexVerifiedInstall
brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).Stars: 198kUpdated Claude CodeCodexVerifiedInstall