# @google-pay/save-button-react 中文文档

规范地址：https://npmcn.com/package/%40google-pay/save-button-react/

版本：1\.0\.0
npm 元数据更新时间：2022-04-05T15:07:33.542Z
中文译文更新时间：2026-11-17T04:57:06.842Z
软件包许可：Apache-2\.0

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

原始 npm 页面：https://www.npmjs.com/package/%40google-pay/save-button-react
原文对照：https://npmcn.com/package/%40google-pay/save-button-react/?lang=original
项目主页：https://github.com/google-pay/save-to-google-pay-button/tree/main/src/save-button-react#readme
源码仓库：https://github.com/google-pay/save-to-google-pay-button

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

- 包体积（解压后）：48.4 kB，9 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=8\.0\.0
- 运行依赖：0 个
- peer 依赖：@types/react \>=16\.0\.0，@types/react-dom \>=16\.0\.0，react \>=16\.3\.0，react-dom \>=16\.3\.0
- 首次发布：2021-03-22T16:21:43.099Z
- 最新版本发布：2021-03-23T17:25:59.132Z
- 近 30 天下载量：6390（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：2（近 12 个月 0 个）

## 中文简介

Google 付费按钮的响应组件

## 安装

```sh
npm install @google-pay/save-button-react
```

也可以使用：`pnpm add @google-pay/save-button-react`、`yarn add @google-pay/save-button-react`、`bun add @google-pay/save-button-react`

## README

# 保存到 Google 付费反应按钮

这是保存到谷歌付费按钮的回放组件 .

## 安装

```sh
npm install @google-pay/save-button-react
```

## 示例用途

```jsx
<SaveToGooglePay jwt="eyJhbGci...7_eD2kT3_IuHxw" height="standard" textsize="large" />
```

可在 [示例文件夹](https://github.com/google-pay/save-to-google-pay-button/tree/main/examples/react/src/examples) 这其中 仓库.

## 文档

### 属性

| 财产 | 类型 | 备注 |
| :-- | :-- | :-- |
| 
竖起

 | 

`string`

 | 

要求.

Google Pay API for Passes Json Web Token (JWT) 曾为Google Pay保存忠诚通行证.

可通过在以下方式生成JWT: [保存到 Google Pay 的通行证](https://developers.google.com/pay/passes/guides/implement-the-api/save-passes-to-google-pay#generate-jwt-that-represents-object) 页 次.

 |
| 

高度

 | 

`"small" | "standard"`

 | 

可选的.

要显示的按钮高度 。 可能的值是: `small` (30px高)和 `standard` (38px高处). 高度默认为 `small`。参见 [谷歌 Pay API 密码按钮](https://developers.google.com/pay/passes/reference/uxguidelines#s2w) 以查看不同按钮的样本 `height` 设置.

默认值 `"small"`。 。 。 .

 |
| 

大小

 | 

`"matchparent" | undefined`

 | 

可选的.

要显示的按钮宽度 。 你可以设置 `size` 改为 `matchparent` 来匹配母元素的宽度。 参见 [谷歌 Pay API 密码按钮](https://developers.google.com/pay/passes/reference/uxguidelines#s2w) 以查看不同按钮的样本 `size` 设置.

默认值 `undefined`。 。 。 .

 |
| 

文本大小

 | 

`"large" | undefined`

 | 

可选的.

何时 `textsize` 联 合 国 `large` ,显示显著地增加文本大小和按钮大小,用于具有特殊UI要求的大小写.

默认值 `undefined`。 。 。 .

 |
| 

主题

 | 

`"dark" | "light"`

 | 

可选的.

要显示的按钮主题 。 可能的值是: `dark` 财务报告和审定财务报表 `light`。默认主题为 `dark`。参见 [谷歌 Pay API 密码按钮](https://developers.google.com/pay/passes/reference/uxguidelines#s2w) 以查看不同按钮的样本 `theme` 设置.

默认值 `"dark"`。 。 。 .

 |

### 回电

| 回电 | 备注 |
| :-- | :-- |
| 
成功时

 | 

当用户成功保存到他们的账户时会引用的回调函数 .

 |
| 

失败

 | 

在保存通关时发生错误时引用的回调 。 第一个伞兵是 `CustomEvent` 地点 `detail` 属性描述错误的细节.

 |
| 

在提供Jwt上

 | 

一个可以用来截取并潜在地操纵JWT的回调功能,在通过被保存到Google Pay之前. 此函数必须返回 a `string`。 。 。 .

 |

访问 [Google Pay API for Passes for Web API 参考文献](https://developers.google.com/pay/passes/reference/s2w-reference) 页:1 关于整合不同按钮属性的更多信息.

## 关于这个软件包

注意此文件夹不含 `package.json` 文档。 这个 `package.json` 文件在构建过程中生成 使用 `package-template.json` 版本编号从 [`package.json`](https://npmcn.com/package/package.json) 此寄存器根中定义的文件.

## 常见问题

### @google-pay/save-button-react 是什么？

Google 付费按钮的响应组件

### 如何安装 @google-pay/save-button-react？

在项目目录运行 npm install @google-pay/save-button-react，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@types/react（\>=16\.0\.0）、@types/react-dom（\>=16\.0\.0）、react（\>=16\.3\.0）、react-dom（\>=16\.3\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @google-pay/save-button-react 支持 TypeScript 吗？

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

### @google-pay/save-button-react 支持 ESM 还是 CommonJS？

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

### @google-pay/save-button-react 需要什么版本的 Node\.js？

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

### @google-pay/save-button-react 可以商用吗？

@google-pay/save-button-react 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @google-pay/save-button-react 的下载量有多少？

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

### @google-pay/save-button-react 还在维护吗？

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

