# @googleworkspace/drive-picker-react 中文文档

规范地址：https://npmcn.com/package/%40googleworkspace/drive-picker-react/

版本：0\.2\.0
npm 元数据更新时间：2025-12-09T17:05:44.897Z
中文译文更新时间：2026-11-16T19:57:03.891Z
软件包许可：Apache-2\.0

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

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

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

- 包体积（解压后）：38.3 kB，14 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：1 个
- peer 依赖：react \>=16\.8\.0，react-dom \>=16\.8\.0
- 首次发布：2025-11-19T19:42:26.625Z
- 最新版本发布：2025-12-09T17:05:44.394Z
- 近 30 天下载量：533702（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：4（近 12 个月 4 个）

## 中文简介

Google 驱动器拾取元素的回放包装

## 安装

```sh
npm install @googleworkspace/drive-picker-react
```

也可以使用：`pnpm add @googleworkspace/drive-picker-react`、`yarn add @googleworkspace/drive-picker-react`、`bun add @googleworkspace/drive-picker-react`

## README

[![npm](https://img.shields.io/npm/v/@googleworkspace/drive-picker-react)](https://www.npmjs.com/package/@googleworkspace/drive-picker-react) [![Test](https://github.com/googleworkspace/drive-picker-element/actions/workflows/test.yml/badge.svg)](https://github.com/googleworkspace/drive-picker-element/actions/workflows/test.yml) ![Release](https://github.com/googleworkspace/drive-picker-element/workflows/Release/badge.svg)

## 说明

此软件包提供了用于 [`@googleworkspace/drive-picker-element`](https://github.com/googleworkspace/drive-picker-element/tree/main/packages/drive-picker-element) 网页组件.

它提供了一种无缝的整合方式 [谷歌拾取器 API](https://developers.google.com/drive/picker/guides/overview) 输入您的反应应用程序.

## 使用量

用来使用 `DrivePicker` 组件中,导入该组件并在组件中使用该组件。 见全 [实例](https://github.com/googleworkspace/drive-picker-element/tree/main/examples) 更多信息

```tsx
import {
  DrivePicker,
  DrivePickerDocsView,
} from "@googleworkspace/drive-picker-react";

function App() {
  return (
    <DrivePicker
      clientId="YOUR_CLIENT_ID"
      appId="YOUR_APP_ID"
      onPicked={(e) => console.log("Picked:", e.detail)}
      onCanceled={() => console.log("Picker was canceled")}
    >
      <DrivePickerDocsView starred={true} />
    </DrivePicker>
  );
}
```

网络的基本组成部分, `@googleworkspace/drive-picker-element`,必须导入这些组件才能工作。 这个 `@googleworkspace/drive-picker-react` 软件包自动为您处理此选项.

## 组件道具

这个 `DrivePicker` 财务报告和审定财务报表 `DrivePickerDocsView` 组件接受与基本网络组件属性相对应的道具.

关于现有道具的完整清单,请参考网络组件的文档:

-   [`<drive-picker>` 属性](https://github.com/googleworkspace/drive-picker-element/tree/main/packages/drive-picker-element#attributes)
-   [`<drive-picker-docs-view>` 属性](https://github.com/googleworkspace/drive-picker-element/tree/main/packages/drive-picker-element#drive-picker-docs-view)

## 活动

您可以通过路过处理事件 `on...` 给 `DrivePicker` 组件.

现有的事件处理人员有:

-   `onPicked`
-   `onCanceled`
-   `onOauthError`
-   `onOauthResponse`

事件争论是 `CustomEvent` 地点 `detail` 属性包含来自 Google Picker API 的有效载荷.

```tsx
<DrivePicker
  ...
  onPicked={(e) => {
    const data = e.detail;
    console.log(data.docs); // Array of picked documents
  }}
/>
```

关于事件有效载荷的更详细情况,请参见: [事件细节部分 `@googleworkspace/drive-picker-element` 读取](https://github.com/googleworkspace/drive-picker-element/tree/main/packages/drive-picker-element#event-details)。 。 。 .

## 参考文献

此组件为包装. 关于网络组件的属性、事件和槽的详细信息,请参见 [`@googleworkspace/drive-picker-element` 读取](https://github.com/googleworkspace/drive-picker-element/tree/main/packages/drive-picker-element)。 。 。 .

## 服务器系统渲染( SSR)

此组件仅设计在客户端环境中工作,因为它依赖于浏览器特定的API(如 `customElements`) (中文(简体) ).

构成部分包括 `"use client"` 指令,使其与Next.js等框架中的React Server组件(RSC)相兼容.

但是,如果遇到SSR的问题或更愿意明确,您可以使用动态导入来禁用此组件的SSR.

### 下一个.js 示例

使用 `next/dynamic`数字 :

```tsx
import dynamic from 'next/dynamic';

const DrivePicker = dynamic(
  () => import('@googleworkspace/drive-picker-react').then((mod) => mod.DrivePicker),
  { ssr: false }
);

const DrivePickerDocsView = dynamic(
  () => import('@googleworkspace/drive-picker-react').then((mod) => mod.DrivePickerDocsView),
  { ssr: false }
);

function App() {
  return (
    <DrivePicker ...>
      <DrivePickerDocsView ... />
    </DrivePicker>
  );
}
```

## 常见问题

### @googleworkspace/drive-picker-react 是什么？

Google 驱动器拾取元素的回放包装

### 如何安装 @googleworkspace/drive-picker-react？

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

### @googleworkspace/drive-picker-react 支持 TypeScript 吗？

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

### @googleworkspace/drive-picker-react 支持 ESM 还是 CommonJS？

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

### @googleworkspace/drive-picker-react 可以商用吗？

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

### @googleworkspace/drive-picker-react 的下载量有多少？

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

### @googleworkspace/drive-picker-react 还在维护吗？

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

