# @edx/frontend-component-cookie-policy-banner 中文文档

规范地址：https://npmcn.com/package/%40edx/frontend-component-cookie-policy-banner/

版本：3\.0\.0
npm 元数据更新时间：2026-07-10T14:29:43.446Z
中文译文更新时间：2026-11-13T07:50:25.817Z
软件包许可：AGPL-3\.0

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

原始 npm 页面：https://www.npmjs.com/package/%40edx/frontend-component-cookie-policy-banner
原文对照：https://npmcn.com/package/%40edx/frontend-component-cookie-policy-banner/?lang=original
项目主页：https://github.com/openedx/frontend-component-cookie-policy-banner#readme
源码仓库：https://github.com/openedx/frontend-component-cookie-policy-banner

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

- 包体积（解压后）：77 kB，34 个文件
- 模块格式：CommonJS
- TypeScript 类型：未声明
- 运行依赖：8 个
- peer 依赖：react ^16\.1\.0 \|\| ^17\.0\.0 \|\| ^18\.0\.0，react-dom ^16\.1\.0 \|\| ^17\.0\.0 \|\| ^18\.0\.0
- 首次发布：2019-09-16T16:43:06.934Z
- 最新版本发布：2025-09-25T13:15:26.540Z
- 近 30 天下载量：7547（2026-10-13 至 2026-11-11，npm 官方下载统计）
- 已发布版本数：38（近 12 个月 0 个）

## 中文简介

EdX cookie政策旗下组件在React中被执行.

## 安装

```sh
npm install @edx/frontend-component-cookie-policy-banner
```

也可以使用：`pnpm add @edx/frontend-component-cookie-policy-banner`、`yarn add @edx/frontend-component-cookie-policy-banner`、`bun add @edx/frontend-component-cookie-policy-banner`

## README

# 前端组件- cookie- 政策屏蔽

[![Greenkeeper badge](https://badges.greenkeeper.io/edx/frontend-component-cookie-policy-banner.svg)](https://greenkeeper.io/) [![npm](https://img.shields.io/npm/v/@edx/frontend-component-cookie-policy-banner.svg)](https://www.npmjs.com/package/@edx/frontend-component-cookie-policy-banner) [![npm](https://img.shields.io/npm/dt/@edx/frontend-component-cookie-policy-banner.svg)](https://www.npmjs.com/package/@edx/frontend-component-cookie-policy-banner) [![license](https://img.shields.io/npm/l/@edx/frontend-component-cookie-policy-banner.svg)](https://github.com/openedx/frontend-component-cookie-policy-banner.svg/blob/master/LICENSE)

我们目前不接受公众为这项重新投资捐款.

## 目的

edX cookie 政策横幅 React 组件

## 开始

## 安装

```bash
npm i --save @edx/frontend-component-cookie-policy-banner
```

## 使用量

```jsx
import CookiePolicyBanner from '@edx/frontend-component-cookie-policy-banner';

// Can import sass file this way
// Or as an import in one of your sass files with other third party sass files
import '@edx/frontend-component-cookie-policy-banner/build/frontend-component-cookie-policy-banner.scss';

const SomeWrappingComponent = () => (
  <div>
    <span>Blahblablah</span>
    <CookiePolicyBanner />
  </div>
);
```

## 更新 Repo

我们用 [`semantic-release`](https://github.com/semantic-release/semantic-release) 更新国家预防机制的一揽子计划.

请遵守语义解析指南, 说明合并更改时如何构建承诺信息 .

### 样式

如前一个代码示例中的注释所指出,您可以导入与该代码相关的样式 `CookiePolicyBanner` 直接组件(如果此组件由您所支持) `webpack` 配置)或通过导入 sass 文件作为您现有 sass 文件的一部分( 可能是您其他第三方 sass 文件导入的地方) .

| 要求: | 这个 `CookiePolicyBanner` sass 文件假定存在 @edx/ brand 主题 |
| :-: | :-- |

```sass
// base.scss
@import 'thirdPartySass';
@import 'anotherThirdPartySass';

// Theme styles
@import '@edx/brand/paragon/fonts';
@import '@edx/brand/paragon/variables';

// Cookie Policy Banner style
@import '@edx/frontend-component-cookie-policy-banner/build/frontend-component-cookie-policy-banner';
```

## 本地测试其它仓库

当前构建不包含在 git 寄存器中, 因此要用依赖寄存器测试组件, 您必须首先通过运行来构建组件 `npm run prepublishOnly`,然后删除 `build` 财务报告和审定财务报表 `build/Release` 从 `.gitignore` 并将结果交给你的分支. **请在合并前将更改移到. gitignore !**

一旦你做出承诺,并将建设推到你的分支,你可以通过添加来将它带入一个依赖寄存器的包.json

```
"@edx/frontend-component-cookie-policy-banner": "git+https://github.com/openedx/frontend-component-cookie-policy-banner#<my_branch_name>"
```

运行 `npm install`。 。 。 .

请注意,每当你改变你的分支, 你将不得不重建, 承诺推 由此形成的建筑文物, 并重新运行 `npm install` 在依赖的仓库中.

## 故事书

![storybook](https://imgur.com/mZct2v5.png)

[`Storybook`](https://github.com/storybooks/storybook) 是一个有用的工具,可以显示组件的预期和潜在用途.

执行

截至2020年11月,"故事本"与"网页包"5不相容,因此在运行前将您的"网页包"版本改为4.44.1.

```bash
npm run start
```

本地构建 `CookiePolicyBanner` 端口组件 `3003`。 。 。 .

## 许可证

此寄存器中的代码根据 AGPLv3 许可, 除非有其它操作 注释.

请看 `LICENSE <LICENSE>`\- 详细情况.

## edX 行为守则

所有社区成员都要遵守《宣言》 `Open edX Code of Conduct` (中文(简体) ). [`https://open.edx.org/code-of-conduct/`](https://open.edx.org/code-of-conduct/)

## 联系人

您可以联系 edx 开源团队 [缩写:oscm@edx.org](mailto:oscm@edx.org)。 。 。 .

## 安全报告信息

请不要公开报告安全问题。 通过电子邮件将安全问题发送给 [安全性@ openedx.org](mailto:security@openedx.org)。 。 。 .

## 常见问题

### @edx/frontend-component-cookie-policy-banner 是什么？

EdX cookie政策旗下组件在React中被执行\.

### 如何安装 @edx/frontend-component-cookie-policy-banner？

在项目目录运行 npm install @edx/frontend-component-cookie-policy-banner，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：react（^16\.1\.0 \|\| ^17\.0\.0 \|\| ^18\.0\.0）、react-dom（^16\.1\.0 \|\| ^17\.0\.0 \|\| ^18\.0\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @edx/frontend-component-cookie-policy-banner 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/edx\_\_frontend-component-cookie-policy-banner 是否存在。

### @edx/frontend-component-cookie-policy-banner 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### @edx/frontend-component-cookie-policy-banner 可以商用吗？

@edx/frontend-component-cookie-policy-banner 使用 AGPL-3\.0 许可。最严格的 Copyleft：除分发外，通过网络向用户提供基于它的服务也需要开源对应源码。闭源 SaaS 使用前务必评估。以上为概括，不构成法律意见，请以许可原文为准。

### @edx/frontend-component-cookie-policy-banner 的下载量有多少？

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

### @edx/frontend-component-cookie-policy-banner 还在维护吗？

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

