@adobe/react-spectrum-charts

中文文档
1.53.1发布于 2026/10/24Apache-2.0TypeScriptESM + CJS构建来源已验证近 30 天下载 3642

React中用于编译Spectrum可视化的宣告库.

中文使用文档
文档目录15 节
  1. 文档
  2. 目录
  3. 概览
  4. 关键特性 :
  5. 安装
  6. 使用量
  7. 示例
  8. 光谱( Adobe 设计系统) 集成
  9. API 密码
  10. 故事书
  11. 支助
  12. 捐款
  13. 许可证
  14. Apache 许可证 2.0 摘要
  15. 路线图

反应光谱图

npm npm

Scatter plot of penguin bill dimensions by species and body mass

文档

反应光谱图

目录

概览

react-spectrum-charts 是一个用于在React中编译图表的宣示性图表库。 它使你能够按照Adobe的设计系统,不费力地绘制视觉惊艳的图表(光谱) 有最小代码. 不需要了解图形的语法或D3或Vega等下层库.

关键特性 :

  • 直观:开发者经验在API设计中居于首位. 声明式API取消了理解高级数据可视化概念的需要. 密码读起来就像你会向别人解释图表一样.

  • 可配置:基于组件的构件使您能够构建解决您的使用大小写的图表。 模块化设计使得用简单易懂的代码来作曲复杂的可视化.

  • 证明:利用光谱Adobe 光谱设计系统)你得到美丽的图表 支持的研究,用户测试,和行业最佳做法.

  • 国际: 支持 30+ 日期/ 数字 地块, 以便用户能够以预期的格式查看数据 .

安装

无

npm install @adobe/react-spectrum-charts @adobe/react-spectrum vega vega-lite

线条

yarn add @adobe/react-spectrum-charts @adobe/react-spectrum vega vega-lite

使用量

react-spectrum-charts 其设计方式使图表的编组与JSX中的任何其他应用内容的编组类似.

每个图表都被包裹在 <Chart/> 组件。 儿童部件及其道具控制图表的内容.

示例

import React from 'react';
import {Axis, Bar, Legend, Chart} from '@adobe/react-spectrum-charts';

const MyChart: FC<MyChartProps> = (props) => {
    ...

    return (
        <Chart data={myChartData}>
            <Axis position="bottom" />
            <Axis position="left" />
            <Bar type="stacked" color="series" />
            <Legend />
        </Chart>
    )
}

光谱( Adobe 设计系统) 集成

Adobe的设计系统有绘制基本图的详细指南,图的颜色选择以及主图组件的设计指南.

react-spectrum-charts 执行本准则时的反应.

API 密码

API 文档

故事书

这个图书馆有一大堆 故事书 每一个组件和大多数道具都有故事 您可以使用故事书中的控制标签来更改组件道具并查看这如何实时地改变图表.

还可以通过选择"Docs"分页来查看任何故事的源代码,向想要的故事滚动并再选择"显示代码". 这有利于在故事书中看到任何故事的完整API.

"故事本"可能包含自每次向主推而被重建后尚未发行的组件或道具,而不仅仅是npm发行后.

支助

遇到任何问题、有问题或需要援助的人 反应-光谱-图,获得支持的方法有几种:

  1. 文档: 检查 正式文件 例如,API文档和开发者文件.

  2. GitHub 问题: 如果您认为您已识别出一个错误或有特性请求或有一般反馈, 请审查列表 未决问题 以查看是否有其他人已经提交了一个类似问题,您可以加入。 如果不存在问题,请使用正确的模板提交新问题(创建一个新问题) (中文(简体) ).

请在寻求支持时尊重并体谅. 在报告问题时尽可能提供背景,并遵循GitHub问题一节所指明的任何准则或模板。 你的反馈和贡献受到高度重视.

捐款

贡献准则

许可证

反应-光谱-图 是在“软件”下发布的开源软件 Apache 许可证 2.0您可以在 自由主义 包含在工程中的文件 .

Apache 许可证 2.0 摘要

  • 权限: 您获得使用、修改、分发和分版软件的广泛许可。 可以作商业用途.

  • 条件:您必须包含原始版权通知和免责声明. 您无法使用项目的商标, 但没有适当的归属 .

  • 限制:许可证不是保证书,软件是"照样"提供的. 项目的出资人不承担任何损失.

  • 更多信息:关于Apache许可证2.0的完整而详细的解释,请参见: 正式许可证文件。 。 。 .

通过使用 反应-光谱-图,你同意遵守 Apache 许可证2.0的条款和条件.

请审查 自由主义 证书的完整文本.

路线图

Github项目跟踪了该项目的路线图。 你一定是Adobe Org的成员 看路线图.

路线图

版本与发布记录

@adobe/react-spectrum-charts 共发布 111 个版本,首次发布于 2023/10/06;过去 12 个月发布了 39 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
1.53.1latest2026/10/2414 天前
1.53.02026/10/2118 天前
1.52.12026/09/181 个月前
1.52.02026/08/132 个月前
1.51.02026/08/132 个月前
1.50.02026/08/122 个月前

其他发布通道:alpha → 1.24.0-alpha.3。

关于 @adobe/react-spectrum-charts 的常见问题

@adobe/react-spectrum-charts 是什么?

React中用于编译Spectrum可视化的宣告库.

如何安装 @adobe/react-spectrum-charts?

在项目目录运行 npm install @adobe/react-spectrum-charts,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:vega(^6.2.0)、react(>= 17.0.2)、react-dom(>= 17.0.2)、vega-lite(^6.4.2)、@adobe/react-spectrum(>=3.23.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@adobe/react-spectrum-charts 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@adobe/react-spectrum-charts 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@adobe/react-spectrum-charts 可以商用吗?

@adobe/react-spectrum-charts 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@adobe/react-spectrum-charts 的下载量有多少?

根据 npm 官方下载统计,@adobe/react-spectrum-charts 在 2026/10/05 – 2026/11/03 这 30 天内被下载 3,642 次,日均约 121 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@adobe/react-spectrum-charts 还在维护吗?

最新版本 1.53.1 发布于 2026/10/24(14 天前);至今共发布 111 个版本,其中过去 12 个月发布了 39 个;首次发布于 2023/10/06。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。