@agions/taroviz 1.10.0 → 1.11.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -16,9 +16,9 @@
16
16
  </p>
17
17
  </div>
18
18
 
19
- ## 📢 最新版本 v1.9.0
19
+ ## 📢 最新版本 v1.10.0
20
20
 
21
- TaroViz v1.9.0 正式发布!本次更新带来完整的无障碍支持(键盘导航 + 屏幕阅读器)、专业动画预设调优、TypeScript 类型系统全面重构。查看 [更新日志](./CHANGELOG.md) 了解详细信息。
21
+ TaroViz v1.10.0 正式发布!新增 **useChartHistory**(Undo/Redo 历史记录)和 **useChartSelection**(数据点选择/高亮)两个专业级 Hook,ErrorBoundary / LazyChart CSS 变量化,ThemeManager 系统主题自动检测。查看 [更新日志](./CHANGELOG.md) 了解详细信息。
22
22
 
23
23
  ## 📚 文档
24
24
 
@@ -36,18 +36,48 @@ TaroViz v1.9.0 正式发布!本次更新带来完整的无障碍支持(键
36
36
  - 📦 **单包架构设计** - 简化依赖管理,方便使用
37
37
  - 🚀 **高性能渲染** - 基于 ECharts 优化,支持懒加载和渐进式渲染
38
38
  - ⚡ **性能分析工具** - 支持帧率监控和内存使用分析
39
- - 🛡️ **错误边界** - 内置 ErrorBoundary 组件,防止图表渲染错误影响应用
39
+ - 🛡️ **错误边界** - 内置 ErrorBoundary 组件,防止图表渲染错误影响应用,支持 CSS 变量主题化
40
40
  - 🪝 **懒加载支持** - 支持图表组件懒加载,优化首屏加载速度
41
+ - ↩️ **Undo/Redo 历史** - useChartHistory Hook 追踪配置变更,支持 Ctrl+Z/Y 快捷键
42
+ - 🎯 **数据点选择** - useChartSelection Hook 支持单选/多选/反选,程序化控制数据高亮
41
43
  - 🎯 **标注系统** - 支持 MarkLine、MarkArea 等标注,预设平均线、警戒线等样式
42
44
  - 📤 **导出功能** - 支持导出为 PNG、JPEG、SVG、PDF 等格式
43
- - 🎯 **易用的 React Hooks** - 提供 useChart、useResize、useResponsive、useThemeSwitcher 等 Hooks
45
+ - 🎯 **易用的 React Hooks** - 提供 useChart、useResize、useResponsive、useThemeSwitcher、useChartHistory、useChartSelection 等 Hooks
44
46
  - ♿ **无障碍支持** - 键盘导航(+/- 缩放、方向键平移、Home 重置)、屏幕阅读器数据表
45
- - 🎬 **专业动画** - 符合设计规范的动画时长和缓动曲线
47
+ - 🎬 **专业动画** - 符合设计规范的动画时长和缓动曲线,支持 prefers-reduced-motion WCAG 无障碍
46
48
  - 📖 **完善的类型定义** - 完整的 TypeScript 类型支持,提升开发体验
47
49
  - 🛠️ **图表配置生成器** - 支持快速生成 ECharts 配置
48
50
  - 🛠️ **代码示例生成器** - 支持 React、Vue、Vanilla 框架
49
51
  - 📚 **完善的文档系统** - 包含在线示例和使用指南
50
52
 
53
+ ## 🪝 Hooks
54
+
55
+ TaroViz 提供多个专业级 React Hooks,简化图表状态管理:
56
+
57
+ ```typescript
58
+ import {
59
+ useChart,
60
+ useChartHistory, // Undo/Redo 历史记录
61
+ useChartSelection, // 数据点选择/高亮
62
+ useChartDownload, // 导出 PNG/JPEG/SVG/PDF/CSV/JSON
63
+ useChartConnect, // 多图表联动
64
+ useDataZoom, // 区域缩放
65
+ useAnimation, // 动画控制
66
+ useThemeSwitcher, // 主题切换
67
+ } from '@agions/taroviz';
68
+
69
+ // Undo/Redo 示例
70
+ const { canUndo, canRedo, undo, redo } = useChartHistory(chartInstance, {
71
+ maxHistorySize: 50,
72
+ enableKeyboard: true, // Ctrl+Z / Ctrl+Y
73
+ });
74
+
75
+ // 数据点选择示例
76
+ const { selectedPoints, select, deselect, clearSelection } = useChartSelection(chartInstance, {
77
+ mode: 'multiple',
78
+ });
79
+ ```
80
+
51
81
  ## 快速开始
52
82
 
53
83
  ### 安装