# BarChart 更新日志

先阅读 [完整 LICENSE](https://snowui.dev/LICENSE)；同任务、同版本、同范围去重。

### v1.4.4 (2026-10-23)

- 共享 HoverPanel 的圆点—名称、名称—数值间距保留 4 CSS px 下限并支持 RTL；保持默认 4px / 8px、较大 Token、图表几何与中心注释。


### v1.4.3 (2026-10-20)

- 内置根名称、数据单元格组名称接入统一 locale；显式 aria-label、业务名称与数字格式保持原有优先级。

- 2026-09-21：统一使用文档、源码属性表与 Site / AI 阅读入口；仅文档修订，不改变组件行为。

### v1.4.1 (2026-09-05)

- 出现时间轴的分类起始偏移改为常量时间计算；HoverPanel pointer 原始事件不再同步读取布局，坐标换算按绘制帧合并。公开 API、柱体几何、时长、视觉和交互语义不变。

### v1.4.0 (2026-09-03)

- 新增 `showBaseLayer=false`，按需开启最终尺寸的同色轮廓；真实图形和出现动效保持原有行为。
- `adaptiveContrast` 改为默认开启，保留显式关闭与子图覆盖。

### v1.3.0 (2026-09-03)

- `adaptiveContrast` 接入 自适应黑白对比共享能力；保留开关默认值、彩色前景、命中和节点状态语义，移除图表私有试验实现。

### v1.2.0 (2026-09-02)

- overlay 复用 `bars` 表达两项独立对比数据，自动 domain、颜色、数字格式、命中和面板统一消费相同数据；支持后层逐项变化和前层超过后层。
- 保留旧字段兼容，未命名后层回退分类名，移除 `Background` 硬编码；缺少后层值时不再复制前层数据。

### v1.1.4 (2026-09-02)

- 新增可选的 `data[].backgroundName`，用于业务化命名 overlay 后层；未提供时保留原名称，几何、颜色与 hover 行为不变。

### v1.1.3 (2026-09-02)

- HoverPanel 默认定位改为 `pointer`，随鼠标移动；区域 hover 默认保持 `cell`，显式的 placement / hoverMode 配置继续优先。

- 2026-09-02 — HoverPanel 改为默认开启，默认外观保持 light。
- 2026-09-02 v1.1.2 — `stack` 数值 label 改为仅在最顶段显示一次并展示全部分段总和，颜色恢复默认 Black/100%；稀疏 X label 自动忽略空项抽稀；HoverPanel 保留 label 与数值行区域 `2px` 间距，名称与数值间距改为 `8px`。
- 2026-09-02 v1.1.1 — 顶部数值 label 不再把安全区增至 `28px`，仍保持柱顶上方 `4px` 并允许溢出绘图区顶边。
- 2026-09-01 v1.1.0 — BarChart 改为按根层最终显示尺寸自行响应；柱宽下限为 `2px`，柱间距下限为 `4px`；修复短横坐标 label 在 cell 小于 `20px` 时仍被误判为可容纳的问题；横坐标抽稀不再删除柱体，并为常驻顶部数值增加独立自动抽稀。
- 2026-09-01 v1.0.4 — 自动 domain 上限改为实际最大数据值，最高 nice tick 不再超过最大值；无 Y 轴场景也不再因向上取整的 domain 产生额外顶部空白。
- 2026-08-31 v1.0.3 — 顶部改为内容感知安全区，并收紧自动 nice domain，避免最高柱、Y 轴顶刻度或数值 label 贴边，同时减少过大的标尺上方空白。
- 2026-08-31 v1.0.2 — 移除笛卡尔绘图区顶部和底部的额外留白；底部仅保留 X 轴标签自身所需的 `24px`。
- 2026-08-31 v1.0.1 — Y 轴改为按最宽可见标签的实际渲染宽度自适应，标签与绘图区之间固定保留 `12px`。
- 2026-06-05 v1.0.0 — 新增 BarChart，支持纵向 / 横向、单柱、多段、相叠、多柱并排、坐标轴与 Chart 出现动效；出现动效采用 80% 初始高度、固定分类间隔、Frame morph 基准时长与单柱独立缓动的逐柱升高形式，label 数值可随柱高补间变化。