@googleworkspace/drive-picker-react

中文文档
0.2.0发布于 2025/12/10Apache-2.0TypeScriptES Module构建来源已验证近 30 天下载 53.4万

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

中文使用文档
文档目录7 节
  1. 说明
  2. 使用量
  3. 组件道具
  4. 活动
  5. 参考文献
  6. 服务器系统渲染( SSR)
  7. 下一个.js 示例

npm Test Release

说明

此软件包提供了用于 @googleworkspace/drive-picker-element 网页组件.

它提供了一种无缝的整合方式 谷歌拾取器 API 输入您的反应应用程序.

使用量

用来使用 DrivePicker 组件中,导入该组件并在组件中使用该组件。 见全 实例 更多信息

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 组件接受与基本网络组件属性相对应的道具.

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

活动

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

现有的事件处理人员有:

  • onPicked
  • onCanceled
  • onOauthError
  • onOauthResponse

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

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

关于事件有效载荷的更详细情况,请参见: 事件细节部分 @googleworkspace/drive-picker-element 读取。 。 。 .

参考文献

此组件为包装. 关于网络组件的属性、事件和槽的详细信息,请参见 @googleworkspace/drive-picker-element 读取。 。 。 .

服务器系统渲染( SSR)

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

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

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

下一个.js 示例

使用 next/dynamic数字 :

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 共发布 4 个版本,首次发布于 2025/11/20;过去 12 个月发布了 4 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.2.0latest2025/12/1011 个月前
0.1.32025/12/0511 个月前
0.1.22025/12/0211 个月前
0.1.12025/11/2011 个月前

关于 @googleworkspace/drive-picker-react 的常见问题

@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 和提交记录判断。