TPVFormer – 強大的表單生成器

一、功能簡介

TPVFormer是一個強大的表單生成器。它使用PHP開發，採用MVC模式，可以方便地生成各種各樣的表單，例如註冊表單、登錄表單、意見反饋表單等等。TPVFormer支持多種表單元素，包括文本框、密碼框、下拉框、單選框、複選框、文本域等等。同時，它還可以通過簡單配置來實現前端表單驗證，保證用戶數據的合法性。

二、使用說明

TPVFormer的使用非常簡單。您只需要在控制器中調用TPVFormer的相關方法即可，通過不同的參數配置就可生成不同樣式、不同功能的表單。以下是生成一個包含用戶名、密碼、確認密碼、郵箱、性別、愛好、頭像上傳的註冊表單的示例代碼：

// 載入TPVFormer類
require_once('path/to/TPVFormer.php');

// 創建一個新的表單實例
$form = new TPVFormer\Form();

// 添加「用戶名」文本框元素
$form->addElement('username', 'text', [
    'label' => '用戶名：',
    'attributes' => [
        'required' => true,
        'maxlength' => 20
    ],
    'form_group_class' => 'form-group col-md-6'
]);

// 添加「密碼」密碼框元素
$form->addElement('password', 'password', [
    'label' => '密碼：',
    'attributes' => [
        'required' => true,
        'minlength' => 6,
        'maxlength' => 20
    ],
    'form_group_class' => 'form-group col-md-6'
]);

// 添加「確認密碼」密碼框元素
$form->addElement('confirm_password', 'password', [
    'label' => '確認密碼：',
    'attributes' => [
        'required' => true,
        'minlength' => 6,
        'maxlength' => 20,
        'equalTo' => '#password'
    ],
    'form_group_class' => 'form-group col-md-6'
]);

// 添加「郵箱」文本框元素
$form->addElement('email', 'email', [
    'label' => '郵箱：',
    'attributes' => [
        'required' => true,
        'maxlength' => 50,
        'email' => true
    ],
    'form_group_class' => 'form-group col-md-6'
]);

// 添加「性別」單選框元素
$form->addElement('gender', 'radio', [
    'label' => '性別：',
    'options' => [
        'male' => '男',
        'female' => '女'
    ],
    'attributes' => [
        'required' => true
    ],
    'form_group_class' => 'form-group col-md-6'
]);

// 添加「愛好」複選框元素
$form->addElement('hobby', 'checkbox', [
    'label' => '愛好：',
    'options' => [
        'music' => '音樂',
        'movie' => '電影',
        'sport' => '運動'
    ],
    'form_group_class' => 'form-group col-md-6'
]);

// 添加「頭像」文件上傳元素
$form->addElement('avatar', 'file', [
    'label' => '頭像：',
    'attributes' => [
        'accept' => '.jpg,.png,.jpeg'
    ],
    'form_group_class' => 'form-group col-md-12'
]);

// 渲染表單
echo $form->render();

以上代碼中，我們通過addElement方法傳入表單元素類型、元素名稱、元素屬性等參數，最後通過render方法將表單渲染出來。

三、前端驗證配置

TPVFormer還支持前端表單驗證配置，通過簡單的配置，我們可以實現各種各樣的表單驗證。以下是一個示例代碼，實現了對「用戶名」、「密碼」和「確認密碼」的前端驗證：

$form->addElement('username', 'text', [
    'label' => '用戶名：',
    'attributes' => [
        'required' => true,
        'maxlength' => 20
    ],
    'form_group_class' => 'form-group col-md-6',
    'validate' => [
        'rules' => [
            'remote' => [
                'url' => 'check_username.php',
                'type' => 'get',
                'data' => [
                    'username' => 'username'
                ]
            ]
        ],
        'messages' => [
            'remote' => '該用戶名已被使用'
        ]
    ]
]);

$form->addElement('password', 'password', [
    'label' => '密碼：',
    'attributes' => [
        'required' => true,
        'minlength' => 6,
        'maxlength' => 20
    ],
    'form_group_class' => 'form-group col-md-6',
    'validate' => [
        'rules' => [
            'pwcheck' => true
        ],
        'messages' => [
            'pwcheck' => '密碼必須包含字母、數字和特殊字元'
        ]
    ]
]);

$form->addElement('confirm_password', 'password', [
    'label' => '確認密碼：',
    'attributes' => [
        'required' => true,
        'minlength' => 6,
        'maxlength' => 20,
        'equalTo' => '#password'
    ],
    'form_group_class' => 'form-group col-md-6',
    'validate' => [
        'rules' => [
            'pwcheck' => true,
            'equalTo' => '#password'
        ],
        'messages' => [
            'pwcheck' => '密碼必須包含字母、數字和特殊字元',
            'equalTo' => '兩次密碼輸入不一致'
        ]
    ]
]);

以上代碼中，我們通過validate參數來配置了前端驗證規則和錯誤信息。例如「用戶名」所對應的元素添加了一個remote規則，這意味著在用戶輸入完成後，前端會向check_username.php發送一個GET請求，檢查輸入的用戶名是否已被使用。如果已被使用，則顯示錯誤信息「該用戶名已被使用」。同時，我們還為「密碼」和「確認密碼」分別添加了一個自定義規則「pwcheck」，這個規則會檢查密碼是否包含字母、數字和特殊字元。

四、總結

TPVFormer是一個非常強大、易於使用的表單生成器。它支持多種表單元素和前端驗證配置，可以為開發者節省大量的時間和精力。使用TPVFormer，您可以輕鬆地創建各種各樣的表單，讓您的網站體驗更加完美！