# @ggts-sh/svelte 中文文档

规范地址：https://npmcn.com/package/%40ggts-sh/svelte/

版本：0\.48\.3
npm 元数据更新时间：2026-11-05T23:52:27.228Z
中文译文更新时间：2026-11-16T07:46:01.111Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40ggts-sh/svelte
原文对照：https://npmcn.com/package/%40ggts-sh/svelte/?lang=original
项目主页：https://ggts.sh/
源码仓库：https://github.com/ggts-sh/ggts

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：1.4 MB，660 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=22
- 运行依赖：3 个
- peer 依赖：svelte ^5\.33\.1
- 首次发布：2026-09-08T13:04:03.514Z
- 最新版本发布：2026-11-05T23:52:26.853Z
- 近 30 天下载量：4256（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：11（近 12 个月 11 个）

## 中文简介

ggts:用于斯维尔特5的分层图形语法——ggplot2语义,JSON-序列可分谱,代理友好验证,和混合SVG/canvas渲染. ggts使CLI舰分别成为@ggts-sh/cli.

## 安装

```sh
npm install @ggts-sh/svelte
```

也可以使用：`pnpm add @ggts-sh/svelte`、`yarn add @ggts-sh/svelte`、`bun add @ggts-sh/svelte`

## README

# @ggts-sh/ svelte (英语)

[![codecov](https://codecov.io/gh/ggts-sh/ggts/branch/main/graph/badge.svg?component=packages-svelte)](https://app.codecov.io/gh/ggts-sh/ggts/tree/main/packages%2Fsvelte)

胶囊5个组件 再出口 `@ggts-sh/spec` 财务报告和审定财务报表 `@ggts-sh/core`。代理技能船分别作为 [`@ggts-sh/skill`](https://www.npmjs.com/package/@ggts-sh/skill),则 `ggts render` CLI 作为 [`@ggts-sh/cli`](https://www.npmjs.com/package/@ggts-sh/cli) - 两者都安装在 每个沙盒里都有代理作者.

```sh
bun add @ggts-sh/svelte @ggts-sh/core
# or: npm install @ggts-sh/svelte @ggts-sh/core
```

需要节点.js 22+和斯维尔特 5.33.1+. 导入捆绑数据示例 从 `@ggts-sh/core/data`,因此它安装了核心作为直接依赖. 内含数据的图表仅需 `@ggts-sh/svelte`。 。 。 .

## 示例

与只申报的儿童(主题、尺度、实验室、地理学)作曲。 别放 `theme`, (中文(简体) ), `scales`, (中文(简体) ), `labs`, (中文(简体) ), `guides`, (中文(简体) ), `facet`, (中文(简体) ), `coord`,或 `legend` 打开 `<GGPlot>` 这些道具在0.13.0被移除.

```svelte
<script lang="ts">
  import {
    GeomPoint,
    GeomSmooth,
    GGPlot,
    Labs,
    ThemeMinimal,
  } from "@ggts-sh/svelte";
  import { kyotoSakura } from "@ggts-sh/core/data";
</script>

<GGPlot data={kyotoSakura} aes={{ x: "year", y: "bloomDoy" }}>
  <GeomSmooth method="loess" se={false} />
  <GeomPoint size={2} alpha={0.7} />
  <ThemeMinimal />
  <Labs
    title="Kyoto cherry blossom full-bloom dates, 812–2026"
    subtitle="Full bloom moved about ten days earlier after the industrial era"
    x="Year"
    y="Day of year"
  />
</GGPlot>
```

常规(ggplot2思维顺序):先标出分层,再标出分层/分层 / 层面,然后是主题/指南/实验室,然后是主机 `<Inspect>` 最后一个 语气 在画布、轴、传奇、文字和可获取的描述上可渲染出点 留在DOM内。 偏爱 `<Inspect />` 财务报告和审定财务报表 `<GuideLegend channel focus>` 编号 : `<GuideLegend channel filter>` 用于交互,而不是图层 `inspect`, (中文(简体) ), `legendFocus`,或 `legendFilter`。 。 。 .

## 更小的捆绑:精细的输入

`@ggts-sh/svelte` 登记基本地理、统计、颜色和样式 缩放类型。 仅运出您的图表所使用的, 导入 从 `@ggts-sh/svelte/lean` 并启动时立即调用注册功能 :

```svelte
<script lang="ts" module>
  import {
    registerBasicLines,
    registerBasicPoints,
    registerDefaultOrdinalColor,
  } from "@ggts-sh/svelte/lean";

  registerBasicPoints();
  registerBasicLines();
  registerDefaultOrdinalColor();
</script>

<script lang="ts">
  import { GeomLine, GeomPoint, GGPlot } from "@ggts-sh/svelte/lean";
</script>
```

对于有映射出颜色的点和行图,这节省了大约26 KB gzip. 如果一张图表需要一个没有注册的家庭, `GGPlot` 丢出错误 指定要调用的注册函数的名称。 一个从 `@ggts-sh/svelte` 在应用程序的任何地方 带来完整的基本注册.

## 代理技能

单独公布为 [`@ggts-sh/skill`](https://www.npmjs.com/package/@ggts-sh/skill)数字 : `node_modules/@ggts-sh/skill/SKILL.md`复制到您的代理技能中 目录为 `ggts/` 并重印于版本的凸起相接相接的表面 这些 (0.27.0从本包中取出

Emit PortableSpec JSON, 运行 `validate()`,应用 `fix.example` 时间 `path`, (中文(简体) ), 重新验证,然后以 `<GGPlot spec={…} />`, (中文(简体) ), `renderToSVGString`,或 `ggts render`示马: [计划/v0.json](https://ggts.sh/schema/v0.json)。 。 。 .

## 移动旧代码

如果你还有0.13前的 手持语法道具的来源 `<GGPlot>`,则 代码重写给孩子 :

```sh
npm exec --package=@ggts-sh/svelte -- ggts-codemod src          # show what would change
npm exec --package=@ggts-sh/svelte -- ggts-codemod --write src  # apply
```

形状不会重写为 `manual change required` 链接 [升级 指南](https://ggts.sh/guide/upgrading)从来没有半移民.

## 链接

-   [文档](https://ggts.sh/)
-   [开始](https://ggts.sh/guide/getting-started)
-   [示例画廊](https://ggts.sh/examples)
-   [互动](https://ggts.sh/reference/interactions)
-   [升级](https://ggts.sh/guide/upgrading)
-   [CLI (中文(简体) )`@ggts-sh/cli`(中文(简体) )](https://www.npmjs.com/package/@ggts-sh/cli)
-   [仓库](https://github.com/ggts-sh/ggts)

预1.0. 使用寿命和兼容性合同在文件网站上.

[麻省理工学院](https://github.com/ggts-sh/ggts/blob/main/LICENSE) 利亚姆·奥德

## 常见问题

### @ggts-sh/svelte 是什么？

ggts:用于斯维尔特5的分层图形语法——ggplot2语义,JSON-序列可分谱,代理友好验证,和混合SVG/canvas渲染\. ggts使CLI舰分别成为@ggts-sh/cli\.

### 如何安装 @ggts-sh/svelte？

在项目目录运行 npm install @ggts-sh/svelte，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：svelte（^5\.33\.1）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。它还提供命令行工具 ggts-codemod，可以用 npx ggts-codemod 直接运行。

### @ggts-sh/svelte 支持 TypeScript 吗？

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

### @ggts-sh/svelte 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @ggts-sh/svelte 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=22。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @ggts-sh/svelte 可以商用吗？

@ggts-sh/svelte 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @ggts-sh/svelte 的下载量有多少？

根据 npm 官方下载统计，@ggts-sh/svelte 在 2026/10/17 – 2026/11/15 这 30 天内被下载 4,256 次，日均约 142 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @ggts-sh/svelte 还在维护吗？

最新版本 0\.48\.3 发布于 2026/11/06（10 天前）；至今共发布 11 个版本，其中过去 12 个月发布了 11 个；首次发布于 2026/09/08。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。

