# @apostrophecms/form 中文文档

规范地址：https://npmcn.com/package/%40apostrophecms/form/

版本：1\.5\.6
npm 元数据更新时间：2026-10-20T16:57:22.508Z
中文译文更新时间：2026-11-06T22:39:15.345Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40apostrophecms/form
原文对照：https://npmcn.com/package/%40apostrophecms/form/?lang=original
项目主页：https://github.com/apostrophecms/apostrophe/tree/main/packages/form
源码仓库：https://github.com/apostrophecms/apostrophe

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

- 包体积（解压后）：213 kB，66 个文件
- 模块格式：CommonJS
- TypeScript 类型：未声明
- 运行依赖：1 个
- 首次发布：2021-10-14T18:07:55.517Z
- 最新版本发布：2026-10-14T18:16:14.935Z
- 近 30 天下载量：2241（2026-10-07 至 2026-11-05，npm 官方下载统计）
- 已发布版本数：19（近 12 个月 4 个）

## 中文简介

在简单的用户界面中构建 ApospropheCMS 的表单.

## 安装

```sh
npm install @apostrophecms/form
```

也可以使用：`pnpm add @apostrophecms/form`、`yarn add @apostrophecms/form`、`bun add @apostrophecms/form`

## README

![ApostropheCMS logo](https://raw.githubusercontent.com/apostrophecms/apostrophe/main/logo.svg)

# ApostropeCMS 窗体构建器

 [![](https://img.shields.io/badge/MADE%20FOR%20ApostropheCMS-000000.svg?style=for-the-badge&logo=Apostrophe&labelColor=6516dd)](https://docs.apostrophecms.org/)[![](https://img.shields.io/discord/517772094482677790?color=5865f2&label=Join%20the%20Discord&logo=discord&logoColor=fff&labelColor=000&style=for-the-badge&logoWidth=20) ](http://chat.apostrophecms.org/)[![](https://img.shields.io/static/v1?style=for-the-badge&labelColor=000000&label=License&message=MIT&color=3DA639)](https://github.com/apostrophecms/apostrophe/blob/main/packages/form/LICENSE.md)

**让内容团队在没有开发者干预的情况下建立和管理表格.** 编辑器可以直接在CMS中创建联系表,调查,申请和注册,然后将它们放置在您网站的任何地方. 表格自动处理提交、电子邮件通知、验证和垃圾邮件保护.

## 为什么是造型器?

-   **无代码窗体创建**: 编辑器通过可配置的字段部件构建窗体——没有给开发者的票
-   **自动数据收集**: 以可选电子邮件通知保存到 MongoDB 的提交
-   **\* 内设安保**: reCAPTCHA v3 整合和验证防止垃圾邮件
-   **设计自由**: 品牌一致性定制CSS课程和样式钩
-   **方便开发者**: 事件钩、自定义验证符和可扩展字段类型
-   **电子邮件准备**: 自动向多个收件人提交路由

## 目录

-   [安装](https://npmcn.com/package/%40apostrophecms/form/#readme-installation)
-   [使用量](https://npmcn.com/package/%40apostrophecms/form/#readme-usage)
    -   [模块配置](https://npmcn.com/package/%40apostrophecms/form/#readme-module-configuration)
    -   [如何运作](https://npmcn.com/package/%40apostrophecms/form/#readme-how-it-works)
    -   [将窗体部件添加到区域](https://npmcn.com/package/%40apostrophecms/form/#readme-adding-form-widget-to-areas)
    -   [编辑工作流程](https://npmcn.com/package/%40apostrophecms/form/#readme-editor-workflow)
-   [配置](https://npmcn.com/package/%40apostrophecms/form/#readme-configuration)
    -   [主要模块选项](https://npmcn.com/package/%40apostrophecms/form/#readme-main-module-options)
    -   [可用的字段类型](https://npmcn.com/package/%40apostrophecms/form/#readme-available-field-types)
-   [处理提交材料](https://npmcn.com/package/%40apostrophecms/form/#readme-handling-submissions)
    -   [数据库存储](https://npmcn.com/package/%40apostrophecms/form/#readme-database-storage)
    -   [电子邮件通知](https://npmcn.com/package/%40apostrophecms/form/#readme-email-notifications)
    -   [服务器系统事件](https://npmcn.com/package/%40apostrophecms/form/#readme-server-side-events)
    -   [浏览器事件](https://npmcn.com/package/%40apostrophecms/form/#readme-browser-events)
-   [reCAPTCHA 一体化](https://npmcn.com/package/%40apostrophecms/form/#readme-recaptcha-integration)
    -   [配置选项](https://npmcn.com/package/%40apostrophecms/form/#readme-configuration-options)
-   [样式](https://npmcn.com/package/%40apostrophecms/form/#readme-styling)
    -   [自定义 CSS 类](https://npmcn.com/package/%40apostrophecms/form/#readme-custom-css-classes)
-   [字段特定选项](https://npmcn.com/package/%40apostrophecms/form/#readme-field-specific-options)
    -   [选择字段](https://npmcn.com/package/%40apostrophecms/form/#readme-select-field)
    -   [文件上传字段](https://npmcn.com/package/%40apostrophecms/form/#readme-file-upload-field)
-   [自定义字段验证](https://npmcn.com/package/%40apostrophecms/form/#readme-custom-field-validation)
    -   [以超级模式扩展收藏器](https://npmcn.com/package/%40apostrophecms/form/#readme-extending-collectors-with-the-super-pattern)
    -   [示例: 最小字数验证](https://npmcn.com/package/%40apostrophecms/form/#readme-example-minimum-word-count-validation)
    -   [处理错误](https://npmcn.com/package/%40apostrophecms/form/#readme-error-handling)
-   [使用大小写](https://npmcn.com/package/%40apostrophecms/form/#readme-use-cases)
-   [准备好了吗?](https://npmcn.com/package/%40apostrophecms/form/#readme--ready-for-more)
    -   [🚀 **表单的特征**](https://npmcn.com/package/%40apostrophecms/form/#readme--pro-features-for-forms)

## 安装

```bash
npm install @apostrophecms/form
```

## 使用量

### 模块配置

配置您的窗体模块 `app.js` 文件 :

```javascript
import apostrophe from 'apostrophe';

apostrophe({
  root: import.meta,
  shortName: 'my-project',
  modules: {
    // Main form module (must come first)
    '@apostrophecms/form': {},
    // Form widget for adding forms to areas
    '@apostrophecms/form-widget': {},
    // Field widgets (include only the types you need)
    '@apostrophecms/form-text-field-widget': {},
    '@apostrophecms/form-textarea-field-widget': {},
    '@apostrophecms/form-select-field-widget': {},
    '@apostrophecms/form-radio-field-widget': {},
    '@apostrophecms/form-file-field-widget': {},
    '@apostrophecms/form-checkboxes-field-widget': {},
    '@apostrophecms/form-boolean-field-widget': {},
    '@apostrophecms/form-conditional-widget': {},
    '@apostrophecms/form-divider-widget': {},
    '@apostrophecms/form-group-widget': {}
  }
});
```

**模块顺序事项 :** `@apostrophecms/form` 必须在部件模块前显示。 只包含您想要编辑器使用的字段类型 .

### 如何运作

这个 `@apostrophecms/form` 模块创建新 **块类型** 在您的CMS中被称为"Forms". 这表示表格是编辑一次创造的内容, 创建“ 联系表单” 一次, 然后用窗体部件将其放入联系页、 页脚和侧边栏 .

### 将窗体部件添加到区域

要让编辑器在页面或块类型中添加表单,请在一区域中包含表单部件:

```javascript
// modules/contact-page/index.js
export default {
  extend: '@apostrophecms/piece-page-type',
  options: {
    label: 'Contact Page'
  },
  fields: {
    add: {
      contactForm: {
        type: 'area',
        options: {
          max: 1,
          widgets: {
            '@apostrophecms/form': {}
          }
        }
      }
    },
    group: {
      basics: {
        fields: ['contactForm']
      }
    }
  }
};
```

### 编辑工作流程

一旦配置,编辑器可以创建和管理表格:

1.  **创建窗体**:在管理员栏中点击"Forms"并创建新的窗体(如"接触表")
2.  **构建窗体**: 添加字段部件(文本字段、电子邮件、复选框等)并配置选项
3.  **配置提交处理**: 在“ 提交后” 标签中设置电子邮件通知和确认信件
4.  **放置窗体**: 编辑带有窗体区域的任何页面,添加窗体部件,并选择您创建的窗体

编辑器现在可以独立创建和管理表格.

## 配置

### 主要模块选项

配置 `@apostrophecms/form` 使用这些选项:

| 财产 | 类型 | 说明 |
| --- | --- | --- |
| `disableOptionalLabel` | 布尔 | 从可选字段中删除“(可选)”文本。 默认 : `false` |
| `formWidgets` | 对象 | 窗体中允许的字段类型的部件配置 |
| `saveSubmissions` | 布尔 | 设定为 `false` 防止向MongoDB保存提交。 默认 : `true` |
| `emailSubmissions` | 布尔 | 设定为 `false` 隐藏电子邮件通知字段。 默认 : `true` |
| `recaptchaSecret` | 字符串 | ReCAPTCHA 站点配置的秘密密钥 |
| `recaptchaSite` | 字符串 | ReCAPTCHA 集成的站点密钥 |
| `classPrefix` | 字符串 | 窗体元素 CSS 类的命名空间 |
| `uploadLimits` | 对象 | 多部分格式提交文件的限制, 与默认合并 : `fileSize` (每个文件字节,默认: `maxSize` 选项 `@apostrophecms/attachment` 如果设定,否则为20MB), `files` (默认 : `20`, (中文(简体) ), `fields` (默认 : `50`和 `fieldSize` (每个非文件字段字节,默认:1MB). 只接受具有匹配文件字段的窗体的文件 |

### 可用的字段类型

这个 `formWidgets` 选项控制组件编辑器在构建窗体时可以使用。 在您的工程级别配置此选项 `/modules/@apostrophecms/form/index.js` 要覆盖内置默认值的文件。 这是一个 **全球环境** 适用于项目中的所有表格.

默认配置 :

```javascript
// modules/@apostrophecms/form/index.js
export default {
  options: {
    formWidgets: {
      '@apostrophecms/form-text-field': {},
      '@apostrophecms/form-textarea-field': {},
      '@apostrophecms/form-boolean-field': {},
      '@apostrophecms/form-select-field': {},
      '@apostrophecms/form-radio-field': {},
      '@apostrophecms/form-checkboxes-field': {},
      '@apostrophecms/form-conditional': {},
      '@apostrophecms/form-divider': {},
      '@apostrophecms/rich-text': {
        toolbar: [
          'styles', 'bold', 'italic', 'link',
          'orderedList', 'bulletList'
        ]
      }
    }
  }
};
```

丰富的文本部件允许编辑器在表格中添加指令. 任何部件类型都可以包含在这个配置中 .

> **不同形式需要不同的字段类型吗?** 这个 `formWidgets` 选项是全局的,不能设置每个区域或每页。 如果需要单独的一组允许的字段(例如,简单的联系表对详细的申请表),则扩展 `@apostrophecms/form` 模块以创建第二个形式块类型 `formWidgets` 配置 . **不过**,没有额外的控制,所有编辑器都可以使用两种形式类型. 使用 [`@apostrophecms-pro/advanced-permission`](https://apostrophecms.com/extensions/advanced-permission) 限制哪些用户群体可以创建和管理每一种表格——确保初级编辑只能访问基本表格,而高级工作人员可以使用高级表格. [更多了解 Pro 特性](https://npmcn.com/package/%40apostrophecms/form/#readme--ready-for-more)。 。 。 .

## 处理提交材料

### 数据库存储

提交文件自动保存到 `aposFormSubmissions` 芒果DB收藏. 要禁用数据库存储 :

```javascript
// modules/@apostrophecms/form/index.js
export default {
  options: {
    saveSubmissions: false
  }
};
```

### 电子邮件通知

若为 `@apostrophecms/email` 被配置,表格可以自动向多个收件人发送电子邮件。 在窗体编辑器中,导航到"After-Submission"分页,并在"Email address (es) for Results"字段中输入以逗号分隔的电子邮件地址.

隐藏电子邮件通知字段 :

```javascript
// modules/@apostrophecms/form/index.js
export default {
  options: {
    emailSubmissions: false
  }
};
```

> **QQ 电子邮件配置**: 要通过电子邮件发送表单, 您必须首先配置 `@apostrophecms/email` 模块。 见 [电子邮件配置指南](https://docs.apostrophecms.org/guide/sending-email.html) 用于设置指令。 表格仍然可以在没有电子邮件配置的情况下保存提交到数据库.

### 服务器系统事件

表格提交会触发您可以在代码中处理的事件,用于自定义处理,集成,或修改提交数据. 例如,您可以向外部的CRM发送提交,添加像查询参数这样的服务器侧元数据,或者触发自定义工作流程.

**`submission` 事件** - 每一份表格均开火:

```javascript
// modules/@apostrophecms/form/index.js
export default {
  handlers(self) {
    return {
      'submission': {
        async handleSubmission(req, form, submission) {
          // Your custom logic here
          console.log('Form submitted:', form.title);
          console.log('Data:', submission);
        }
      }
    };
  }
};
```

**`beforeSaveSubmission` 事件** - 在救救之前先开火 `info.submission` 至数据库(如果启用)

```javascript
// modules/@apostrophecms/form/index.js
export default {
  handlers(self) {
    return {
      'beforeSaveSubmission': {
        async modifySubmission(req, info) {
          // Modify info.submission before it's saved
          info.submission.processedAt = new Date();
        }
      }
    };
  }
};
```

事件处理器参数 :

| 活动 | 参数 | 说明 |
| --- | --- | --- |
| `submission` | `req`, (中文(简体) ), `form`, (中文(简体) ), `submission` | 请求对象、格式文件、提交数据 |
| `beforeSaveSubmission` | `req`, (中文(简体) ), `info` | 请求反对,反对 `form`, (中文(简体) ), `data`,以及 `submission` 属性 |

### 浏览器事件

窗体模块释放浏览器事件 `body` 提交尝试后的元素。 你可以听这些添加 **自定义客户端反馈或分析**。 。 。 .

#### 成功活动

`@apostrophecms/form:submission-form` 成功处理提交文件时开火。 活动细节包括: `form` 属性.

```js
document.body.addEventListener('@apostrophecms/form:submission-form', e => {
  // e.detail.form contains the form element/config
  console.log('Form submitted successfully:', e.detail.form);

  // Example: show a toast notification
  apos.notify('✅ Thanks for your submission!', { type: 'success' });

  // Example: send analytics event
  gtag('event', 'form_submission', {
    formTitle: e.detail.form.title || 'Untitled Form'
  });
});
```

#### 失败事件

`@apostrophecms/form:submission-failed` 当一个提交由于验证错误,垃圾邮件保护,或服务器问题而失败时会起火. 活动细节包括: `formError` 属性.

```js
document.body.addEventListener('@apostrophecms/form:submission-failed', e => {
  // e.detail.formError contains the error info
  console.error('Form submission failed:', e.detail.formError);

  // Example: show a custom error banner
  apos.notify('⚠️ Something went wrong. Please try again.', { type: 'danger' });

  // Example: track failed attempts
  gtag('event', 'form_submission_failed', {
    error: e.detail.formError.message || 'Unknown'
  });
});
```

**使用大小写**

-   将默认“ 谢谢” UI 替换为自定义成功消息
-   将事件推入 Google 标签管理器、 片段或其他分析
-   成功提交后重定向或滚动页面
-   失败时显示定制错误信息

> **说明:** 提交后消息中已包含的窗体支持( E)`thankYouHeading`, (中文(简体) ), `thankYouBody`)和内置错误处理。 您只需要这些浏览器事件, 只要您想要额外的客户端行为, 超出模块提供的选项 .

## reCAPTCHA 一体化

使用 Google reCAPTCHA v3 保护表格免受垃圾邮件影响 [google.com/ recaptcha (英语)](https://www.google.com/recaptcha/) 使用版本 3,然后配置您的站点和密钥.

### 配置选项

**备选方案1:模块配置中的硬码**

```javascript
// modules/@apostrophecms/form/index.js
export default {
  options: {
    recaptchaSecret: 'YOUR_SECRET_KEY',
    recaptchaSite: 'YOUR_SITE_KEY'
  }
};
```

**选项2:允许编辑器在 UI 中配置**

如果您不使用硬码两种密钥, 则会出现全局设置 UI , 管理员可以输入它们 。 一旦配置,每个表单都有一个复选框,可以独立启用 reCAPTCHA.

## 样式

### 自定义 CSS 类

添加您自己的类前缀以形成完整的样式控制元素 :

```javascript
// modules/@apostrophecms/form/index.js
export default {
  options: {
    classPrefix: 'my-form'
  }
};
```

这产生了 BEM 风格的类 `my-form__input`, (中文(简体) ), `my-form__label`,以及 `my-form__error` 关于形式要素.

对于更喜欢外观设计工具的团队,Aposrope的内置 [全局样式](https://docs.apostrophecms.org/guide/global-styles.html) 让编辑器从管理员界面中调整 CSS 属性,而不写入代码.

## 字段特定选项

### 选择字段

选定字段部件支持多个选择 :

```javascript
// modules/@apostrophecms/form-select-field-widget/index.js
export default {
  options: {
    allowMultiple: true  // Default: false
  }
};
```

当启用时, 部件计划中会出现另外两个字段 :

| 财产 | 类型 | 说明 | 默认 |
| --- | --- | --- | --- |
| `allowMultiple` | 布尔 | 启用多个选择 . | `false` |
| `size` | 整数 | 可见选项的数量 。 设定为 `0` 以使用默认的压缩降;设置为 `2` 或更高值以生成列表框,同时显示多个选项. | `0` |

### 文件上传字段

⚠️ **安全警告**:文件上传字段允许任何访问者将文件上传到您的服务器,从而造成存储滥用和恶意上传的潜在风险. 这个部件是 **默认未包含**\- 你必须明确允许它.

**何处执行安全措施:**

1.  **储存提供者级别** (AWS S3,谷歌云存储,Azure Blob):
    
    -   在您的服务商控制台中配置文件类型限制、大小限制和生命周期政策
    -   设置桶配额和异常上传模式的提示
    -   查看您的提供者关于内容验证功能的文档
2.  **ApostropeCMS 附加模块** (单位:千美元)`modules/@apostrophecms/attachment/index.js`:
    
    ```javascript
    export default {
      options: {
        // Restrict file types (extension allowlist)
        fileGroups: [
          {
            name: 'images',
            label: 'Images',
            extensions: [ 'jpg', 'jpeg', 'png', 'gif', 'webp' ],
            extensionMaps: { jpeg: 'jpg' }
          },
          {
            name: 'office',
            label: 'Documents',
            extensions: [ 'pdf', 'doc', 'docx', 'xls', 'xlsx' ],
            extensionMaps: {}
          }
        ],
        // Set maximum file size (in bytes)
        maxSize: 10485760  // 10MB
      }
    };
    ```
    
    见 [附件模块文档](https://docs.apostrophecms.org/reference/modules/attachment.html) 用于完整的配置选项.
    
3.  **表格提交处理器** (用于补充审定):
    
    ```javascript
    // modules/@apostrophecms/form/index.js
    export default {
      handlers(self) {
        return {
          'beforeSaveSubmission': {
            async validateFiles(req, info) {
              // Add custom file validation logic here
              // Access uploaded files via info.data
            }
          }
        };
      }
    };
    ```
    
4.  **垃圾邮件保护**: 启用 reCAPTCHA v3(参见 [reCAPTCHA 一体化](https://npmcn.com/package/%40apostrophecms/form/#readme-recaptcha-integration) 页:1
    

文件存储在您配置的附件存储中( 本地上传或云桶) 。 提交表保存附件 URL,而不是文件本身 .

**多个文件上传**: 与所选字段一样,文件字段部件支持一个 `allowMultiple` 选项 :

```javascript
// modules/@apostrophecms/form-file-field-widget/index.js
export default {
  options: {
    allowMultiple: true  // Default: false
  }
};
```

启用时,用户可以选择并上传多个格式提交文件.

## 自定义字段验证

需要商业特定规则,如最小字数、格式要求或跨字段依赖性? 扩展内置的字段收藏器在提交前添加自定义验证逻辑. 这将运行客户端以获取即时反馈而无需服务器回路 .

每个字段从位于 `apos.aposForm.collectors` 浏览器中的数组。 您可以将这些收藏器的功能扩展为调整值或在表单发布到服务器之前进行额外的验证. 如果需要,可以将收集器函数写成同步函数.

收集器函数将部件元素作为参数,并在成功提交时返回响应对象。 响应对象属性为:

| 财产 | 说明 |
| --- | --- |
| `field` | 现场元素 `name` 属性( 与字段部件相同) `name` (财产) |
| `value` | 字段值 |

### 以超级模式扩展收藏器

这些功能可以被扩展为使用超级模式进行项目级验证. 这包括:

1.  将原始函数指定为变量
2.  创建使用原始功能、添加功能并返回结构相同的响应的新函数
3.  将新函数指派到原函数属性

### 示例: 最小字数验证

```javascript
// modules/@apostrophecms/form-textarea-field-widget/ui/src/index.js

export default () => {
  const TEXTAREA_WIDGET = '@apostrophecms/form-textarea-field';

  // 1️⃣ Store the original collector function on `superCollector`.
  const superCollector = apos.aposForm.collectors[TEXTAREA_WIDGET].collector;

  // 2️⃣ Create a new collector function that accepts the same widget element
  // parameter.
  function newCollector(el) {
    // Get the response from the original collector.
    const response = superCollector(el);

    if (response.value && response.value.split(' ').length < 10) {
      // Throwing an object if there are fewer than ten words.
      throw {
        field: response.field,
        message: 'Write at least 10 words'
      };
    } else {
      // Returning the original response if everything is okay.
      return response;
    }
  }

  // 3️⃣ Assign our new collector to the original property.
  apos.aposForm.collectors[TEXTAREA_WIDGET].collector = newCollector;
};
```

### 处理错误

如果您想要在字段上显示错误, `throw` a 对象,其数值如下(如上所示):

| 财产 | 说明 |
| --- | --- |
| `field` | 现场元素 `name` 属性( 与字段部件相同) `name` (财产) |
| `message` | 作为错误消息在字段中显示的字符串 |

## 使用大小写

**联系人表格**:让团队在没有开发者参与的情况下创建部门特定的联系表格.

**铅生成**: 以有条件的字段来构建转换-优化的形态并重新CAPTCHA保护.

**事件登记**:通过文件上传来文件或照片来收集参与者信息.

**用户反馈**: 创建调查和反馈表,向适当的团队成员提供路径.

**工作应用程序**: 接受带有验证和电子邮件路由的恢复和应用材料.

## 准备好了吗?

开源造型器提供了强大的造型能力,但企业团队往往需要先进的控制和工作流程功能. [**ApostropheCMS 磁带控制系统 赞成**](https://apostrophecms.com/pro) 具有专业级特性的扩展形式功能 :

### 🚀 **表单的特征**

-   **高级权限** - 控制哪些团队可以创建、编辑和管理特定的形式类型。 限制获取人力资源应用程序或客户数据收集等敏感表格. 适合不同部门需要不同形式能力的多团队组织.
    
-   **自动翻译** - 自动将表格和确认信息翻译成多种语言,并配备AI动力翻译服务(DeepL、Google Translate、Azure)。 在不进行人工翻译的情况下部署多语种表格.
    
-   **文件管理** - 对有完整审计线索的表格进行版本控制。 跟踪更改来组成字段,恢复以前的版本,并保持遵守格式修改历史.
    

创建 Aposrophe 工作空间账户并升级到 [**ApostropheCMS 磁带控制系统 赞成**](https://app.apostrophecms.com/login) 或者说 **[联系我们的团队](https://apostrophecms.com/contact-us)** 了解促进形式管理、合规和团队合作的Pro许可和准入企业特征.

* * *

由美国制造 [ApostropheCMS 磁带控制系统](https://apostrophecms.com/) 团队. **发现这个有用吗? [给我们一颗巨星!](https://github.com/apostrophecms/apostrophe) ⭐**

## 常见问题

### @apostrophecms/form 是什么？

在简单的用户界面中构建 ApospropheCMS 的表单\.

### 如何安装 @apostrophecms/form？

在项目目录运行 npm install @apostrophecms/form，或使用 pnpm add / yarn add / bun add。

### @apostrophecms/form 支持 TypeScript 吗？

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

### @apostrophecms/form 支持 ESM 还是 CommonJS？

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

### @apostrophecms/form 可以商用吗？

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

### @apostrophecms/form 的下载量有多少？

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

### @apostrophecms/form 还在维护吗？

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