# @eeacms/volto-columns-block 中文文档

规范地址：https://npmcn.com/package/%40eeacms/volto-columns-block/

版本：9\.0\.5
npm 元数据更新时间：2026-10-30T09:56:53.782Z
中文译文更新时间：2026-11-13T23:45:58.758Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：202 kB，69 个文件
- 模块格式：CommonJS
- TypeScript 类型：未声明
- 运行依赖：1 个
- 首次发布：2020-11-16T20:17:07.174Z
- 最新版本发布：2026-10-30T09:56:53.561Z
- 近 30 天下载量：2864（2026-10-13 至 2026-11-11，npm 官方下载统计）
- 已发布版本数：67（近 12 个月 7 个）

## 中文简介

伏尔托柱-块:伏尔托加成

## 安装

```sh
npm install @eeacms/volto-columns-block
```

也可以使用：`pnpm add @eeacms/volto-columns-block`、`yarn add @eeacms/volto-columns-block`、`bun add @eeacms/volto-columns-block`

## README

# 卷柱-块

[![Releases](https://img.shields.io/github/v/release/eea/volto-columns-block)](https://github.com/eea/volto-columns-block/releases)

[![Pipeline](https://ci.eionet.europa.eu/buildStatus/icon?job=volto-addons%2Fvolto-columns-block%2Fmaster&subject=master)](https://ci.eionet.europa.eu/view/Github/job/volto-addons/job/volto-columns-block/job/master/display/redirect) [![Lines of Code](https://sonarqube.eea.europa.eu/api/project_badges/measure?project=volto-columns-block&metric=ncloc)](https://sonarqube.eea.europa.eu/dashboard?id=volto-columns-block) [![Coverage](https://sonarqube.eea.europa.eu/api/project_badges/measure?project=volto-columns-block&metric=coverage)](https://sonarqube.eea.europa.eu/dashboard?id=volto-columns-block) [![Bugs](https://sonarqube.eea.europa.eu/api/project_badges/measure?project=volto-columns-block&metric=bugs)](https://sonarqube.eea.europa.eu/dashboard?id=volto-columns-block) [![Duplicated Lines (%)](https://sonarqube.eea.europa.eu/api/project_badges/measure?project=volto-columns-block&metric=duplicated_lines_density)](https://sonarqube.eea.europa.eu/dashboard?id=volto-columns-block)

[![Pipeline](https://ci.eionet.europa.eu/buildStatus/icon?job=volto-addons%2Fvolto-columns-block%2Fdevelop&subject=develop)](https://ci.eionet.europa.eu/view/Github/job/volto-addons/job/volto-columns-block/job/develop/display/redirect) [![Lines of Code](https://sonarqube.eea.europa.eu/api/project_badges/measure?project=volto-columns-block&branch=develop&metric=ncloc)](https://sonarqube.eea.europa.eu/dashboard?id=volto-columns-block&branch=develop) [![Coverage](https://sonarqube.eea.europa.eu/api/project_badges/measure?project=volto-columns-block&branch=develop&metric=coverage)](https://sonarqube.eea.europa.eu/dashboard?id=volto-columns-block&branch=develop) [![Bugs](https://sonarqube.eea.europa.eu/api/project_badges/measure?project=volto-columns-block&branch=develop&metric=bugs)](https://sonarqube.eea.europa.eu/dashboard?id=volto-columns-block&branch=develop) [![Duplicated Lines (%)](https://sonarqube.eea.europa.eu/api/project_badges/measure?project=volto-columns-block&branch=develop&metric=duplicated_lines_density)](https://sonarqube.eea.europa.eu/dashboard?id=volto-columns-block&branch=develop)

[沃尔多](https://github.com/plone/volto) 加载

## 特征

这个包给你一个带柱子的块. 每个栏目都是自己的 区块容器.

![Initializing Columns Layout](https://raw.githubusercontent.com/eea/volto-columns-block/master/docs/initialize.png) ![Columns Edit Example](https://raw.githubusercontent.com/eea/volto-columns-block/master/docs/edit.png) ![Columns Sidebar](https://raw.githubusercontent.com/eea/volto-columns-block/master/docs/columns-sidebar.png) ![Single Column Sidebar](https://raw.githubusercontent.com/eea/volto-columns-block/master/docs/single-column-sidebar.png) ![Columns View Example](https://raw.githubusercontent.com/eea/volto-columns-block/master/docs/view.png)

## 开始

### 和多克一起尝试电压柱- 块

```
  git clone https://github.com/eea/volto-columns-block.git
  cd volto-columns-block
  make
  make start
```

转到 http://localhost:3:00

`make start` 现在默认为 Volto 18. 要运行同样的设置 对沃尔多17,使用:

```
  VOLTO_VERSION=17 make
  VOLTO_VERSION=17 make start
```

### 在您的 Volto 项目中添加 Volto- 栏- 块

对于Volto 18和较新的,与 Cookieplone 创建项目. 见官员 Plone 文档 : [用 Cookieplone 安装 Plone](https://6.docs.plone.org/install/create-project-cookieplone.html) 财务报告和审定财务报表 [在 Volto 18 和 19 安装加号](https://6.docs.plone.org/volto/development/add-ons/install-an-add-on.html)。 。 。 .

1.  如果您还没有项目, 请创建 :
    
    ```
    uvx cookieplone project
    cd project-title
    make install
    ```
    
2.  在您的 Volto 工程中安装附加 :
    
    ```
    pnpm --filter <name-of-your-policy-add-on> add @eeacms/volto-columns-block
    ```
    
3.  添加加号到 `volto.config.js`数字 :
    
    ```JavaScript
    const addons = ['@eeacms/volto-columns-block'];
    ```
    
4.  开始 Plone :
    
    ```
    make backend-start
    make frontend-start
    ```
    
5.  转到 http://localhost:3:00
    
6.  剪辑愉快!
    

对于遗产Volto 17项目,继续使用以纱线为基础的Volto 17工作流程.

## 升级

### 升级到 9.x

> 此版本需要 `Volto >= 17.18` 或者说 `Volto 18+`。它取消了习惯 `EditBlockWrapper` 并使用 Volto 的内置块 铬由提供 `BlocksForm`。 。 。 .

#### 中断更改

-   **删除 `EditBlockWrapper.jsx`。 。 。 .** 任何代码导入 `EditBlockWrapper` 从 `@eeacms/volto-columns-block` 将打破。 使用 Volto 内置 `EditBlockWrapper` 从 `@plone/volto/components/manage/Blocks/Block/EditBlockWrapper` 如果您需要自定义包装.
-   **将列设置按钮移至块侧边栏.** 飘来飘去 `column.svg` 图标按钮已删除。 列设置现在可以通过块侧边栏直接访问 `ColumnsWidget`。 。 。 .
-   **`ColumnsBlockSchema` 签名更改 .** `ColumnsBlockSchema` 现在收到单个对象 `{ intl, formData }` 而不是仅仅 `intl`。任何代码调用 `ColumnsBlockSchema(intl)` 必须更新到 `ColumnsBlockSchema({ intl, formData })`。 。 。 .

## 释放

见 [发 言](https://github.com/eea/volto-columns-block/blob/master/RELEASE.md)。 。 。 .

## 如何捐款

见 [发达国家d](https://github.com/eea/volto-columns-block/blob/master/DEVELOP.md)。 。 。 .

## 秘密扫描

此寄存器使用 Betterleaks GitHub 动作扫描当前 每个推拉请求的仓库内容。 扫描使用规则在 `.gitleaks.toml` 上传 a `betterleaks-report` 发现时的文物 检测到.

如果配置了可选的 SMTP 秘密, 失败的扫描也会发送电子邮件到 最后的犯规者。 工作流程期望这些寄存器或 组织机密:

-   `SMTP_URL`
-   `SMTP_PORT` (可选,默认为) `25`(中文(简体) )
-   `SMTP_EMAIL`
-   `SMTP_PASSWORD` (如果 SMTP 服务器不需要认证, 可选择)

端口 `465` 以直接 TLS 发送; 其他端口使用默认 SMTP 握手. 电子邮件中包含一个简短的发现摘要, 包括每个发现中经过编辑的匹配行.

有三个共同的结果:

1.  **一切都没事.** 这个 `Betterleaks / Scan for secrets` 检查为绿色 无需采取行动。 运行时间值的常规引用是确定的, 例如:
    
    ```js
    const tokenFromCookie = req.universalCookies.get('auth_token');
    ```
    
2.  **发现了一个真正的秘密.** 检查为红色,工作流程日志要求您 下载 `betterleaks-report` 艺术品 从 GitHub 打开文物 动作运行并检查报告的文件,行和规则 。 删除已承诺 值,将其移动到合适的密店,如果被曝光则旋转. 报告条目是这样的:
    
    ```json
    {
      "RuleID": "secret-literal-assignment",
      "File": "src/config.js",
      "StartLine": 12,
      "Secret": "[REDACTED]"
    }
    ```
    
3.  **调查结果是虚假的阳性.** 只有在显然没有时才保留该值 敏感,例如测试固定图、占位符或公共实例。 添加 `betterleaks:allow` 在同一行中,并在 拉请求.
    
    ```js
    const testPassword = 'admin'; //betterleaks:allow
    ```
    
    ```yaml
    password: "admin" #betterleaks:allow
    ```
    

不添加 `betterleaks:allow` 到真正的证书.

## 版权和许可证

原始守则的初始所有人是欧洲环境署. 所有权利保留.

见 [利比里亚](https://github.com/eea/volto-columns-block/blob/master/LICENSE.md) 详细情况.

## 供资

[欧洲环境署(欧盟)](http://eea.europa.eu/)

## 常见问题

### @eeacms/volto-columns-block 是什么？

伏尔托柱-块:伏尔托加成

### 如何安装 @eeacms/volto-columns-block？

在项目目录运行 npm install @eeacms/volto-columns-block，或使用 pnpm add / yarn add / bun add。

### @eeacms/volto-columns-block 支持 TypeScript 吗？

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

### @eeacms/volto-columns-block 支持 ESM 还是 CommonJS？

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

### @eeacms/volto-columns-block 可以商用吗？

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

### @eeacms/volto-columns-block 的下载量有多少？

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

### @eeacms/volto-columns-block 还在维护吗？

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