README

Devinci\QuickForm 库提供了一种方便的方式在 PHP 应用程序中动态生成 HTML 表单。使用此库，开发者可以轻松创建和自定义各种输入类型、设置表单属性以及无缝处理表单渲染。

功能

• FormBuilder 类：库的核心组件，允许程序化创建 HTML 表单。
• 支持多种输入类型：文本输入、整数输入、文本区域、日期输入、单选按钮和复选框都受支持。
• 表单属性管理：可以轻松设置表单属性，如方法、操作、类和 id。
• 输入分组：可以将输入字段分组在一起，以便在表单中更好地组织和展示。
• 提交和清除按钮：可以设置带有自定义属性的提交和清除按钮。
• 自定义：根据需求灵活自定义表单元素、属性和按钮。

安装

您可以通过 Composer 安装 Devinci\QuickForm 库

composer require devinci-it/quick-form

或者，您也可以手动将必要的文件包含到您的项目中。

使用方法

1. 实例化 FormBuilder：通过提供表单操作（可选），表单提交方法和一个自定义 HTML 渲染器来创建 FormBuilder 类的实例。

   $formBuilder = new FormBuilder('/submit-form', 'POST');

2. 设置表单属性：可以使用 setFormAttributes 方法选择性地为表单标签设置属性。

   $formBuilder->setFormAttributes([
       'class' => 'my-form',
       'id' => 'my-form-id'
   ]);

3. 添加输入字段：使用 addTextInput、addIntegerInput、addTextArea 等方法向表单添加输入字段。

   $formBuilder->addTextInput('username', 'Enter your username', ['class' => 'form-control']);
   $formBuilder->addIntegerInput('age', 'Enter your age');

4. 分组输入：如果需要，可以使用 setInputGroup 方法将输入字段分组在一起。

   $formBuilder->setInputGroup('personal_info', ['username', 'age']);

5. 设置提交和清除按钮：分别使用 setSubmitButton 和 setClearButton 方法设置提交按钮和清除按钮。

   $formBuilder->setSubmitButton('submit', 'Submit Form', ['class' => 'btn btn-primary']);
   $formBuilder->setClearButton('clear', 'Clear Form', ['class' => 'btn btn-secondary']);

6. 渲染表单：使用 render 方法渲染表单 HTML。

   echo $formBuilder->render();

7. 与 Web 应用程序的集成：通过将生成的表单嵌入 HTML 页面或模板中，可以将其无缝集成到 Web 应用程序中。

8. 自定义：通过修改 CSS 样式、JavaScript 交互和表单处理逻辑，根据应用程序的要求自定义表单的外观和行为。

示例

Devinci QuickForm 库可用于多种用例，包括

• 用户注册表单
• 数据输入表单
• 联系表单
• 调查表单

贡献

欢迎为 Devinci QuickForm 库做出贡献！您可以自由提交错误报告、功能请求或通过 GitHub 提交拉取请求。

许可

此库根据 MIT 许可证授权。有关详细信息，请参阅 LICENSE 文件。