Bootstrap Form 项目教程

Bootstrap Form 项目教程

1. 项目的目录结构及介绍

bootstrap-form/
├── src/
│   ├── Form.php
│   ├── components/
│   │   ├── Checkbox.php
│   │   ├── Date.php
│   │   ├── Email.php
│   │   ├── File.php
│   │   ├── Hidden.php
│   │   ├── Number.php
│   │   ├── Password.php
│   │   ├── Radio.php
│   │   ├── Select.php
│   │   ├── Text.php
│   │   ├── Textarea.php
│   │   └── components.php
│   ├── helpers/
│   │   └── helpers.php
│   ├── traits/
│   │   ├── Active.php
│   │   ├── Attributes.php
│   │   ├── Errors.php
│   │   ├── Groups.php
│   │   ├── Labels.php
│   │   ├── Options.php
│   │   ├── Values.php
│   │   └── traits.php
│   └── FormServiceProvider.php
├── tests/
│   ├── FormTest.php
│   ├── components/
│   │   ├── CheckboxTest.php
│   │   ├── DateTest.php
│   │   ├── EmailTest.php
│   │   ├── FileTest.php
│   │   ├── HiddenTest.php
│   │   ├── NumberTest.php
│   │   ├── PasswordTest.php
│   │   ├── RadioTest.php
│   │   ├── SelectTest.php
│   │   ├── TextTest.php
│   │   ├── TextareaTest.php
│   │   └── componentsTest.php
│   └── TestCase.php
├── composer.json
├── LICENSE
└── README.md

目录结构介绍

• src/: 包含项目的主要源代码。
  • Form.php: 主表单类。
  • components/: 包含各种表单组件的类。
  • helpers/: 包含辅助函数。
  • traits/: 包含各种特性（Traits）。
  • FormServiceProvider.php: 服务提供者类。
• tests/: 包含项目的测试代码。
• composer.json: Composer 配置文件。
• LICENSE: 项目许可证。
• README.md: 项目说明文档。

2. 项目的启动文件介绍

项目的启动文件是 src/FormServiceProvider.php。这个文件是 Laravel 服务提供者，用于注册和启动表单服务。

namespace Dwightwatson\Bootstrap;

use Illuminate\Support\ServiceProvider;

class FormServiceProvider extends ServiceProvider
{
    public function boot()
    {
        // 加载视图
        $this->loadViewsFrom(__DIR__.'/../resources/views', 'bootstrap-form');

        // 发布配置文件
        $this->publishes([
            __DIR__.'/../config/bootstrap-form.php' => config_path('bootstrap-form.php'),
        ]);
    }

    public function register()
    {
        // 合并配置
        $this->mergeConfigFrom(
            __DIR__.'/../config/bootstrap-form.php', 'bootstrap-form'
        );
    }
}

3. 项目的配置文件介绍

项目的配置文件是 config/bootstrap-form.php。这个文件包含了表单的各种配置选项。

return [
    'form_group_class' => 'mb-3',
    'form_label_class' => 'form-label',
    'form_control_class' => 'form-control',
    'form_control_plaintext_class' => 'form-control-plaintext',
    'form_control_sm_class' => 'form-control form-control-sm',
    'form_control_lg_class' => 'form-control form-control-lg',
    'form_check_class' => 'form-check',
    'form_check_input_class' => 'form-check-input',
    'form_check_label_class' => 'form-check-label',
    'form_check_inline_class' => 'form-check form-check-inline',
    'form_select_class' => 'form-select',
    'form_select_sm_class' => 'form-select form-select-sm',
    'form_select_lg_class' => 'form-select form-select-lg',
    'form_text_class' => 'form-text',
    'form_feedback_class' => 'invalid-feedback',
    'form_feedback_valid_class' => 'valid-feedback',
    'form_feedback_icon_valid_class' => 'form-control-feedback-icon-valid',
    'form_feedback_icon_invalid_class' => 'form-control-feedback-icon-invalid',
];

这个配置文件定义了各种表单元素的 CSS 类，以便在项目中统一使用。