SimpleForm2
У simpleForm2 побудова форми здійснюється за допомогою мета-мови і схожа на її побудову в HTML.
Приклади використання simpleForm2
Атрибути тега "element"
- type * - Визначає тип елемента. Можливі значення: text, textarea, select, radio, button, submit, reset, checkbox, captcha, file (елемент "file" додано у версії 1.0.1).
- label * - Визначає напис, що пояснює, біля елемента.
- Required - Якщо значення цього атрибуту дорівнює "required", заповнення даного елемента буде обов'язковим для користувача.
- Regex - Значення цього атрибуту може стати регулярним виразом для оцінки правильності заповнення елемента, у якого призначений цей атрибут.
- error - Значенням цього атрибуту може бути текст повідомлення про помилку, викликану незаплідненням елемента, у якого визначений цей атрибут і атрибут required має значення "required", або введені дані не пройшли перевірку регулярного виразу.
- value - Значення цього атрибута є значенням за промовчанням елемента.
- class - Якщо цей атрибут не порожній, елементу буде заданий CSS клас зі значення цього атрибута.
- multiple - Цей атрибут можна використовувати лише в елементі з типом: select. Визначає, чи можна вибрати кілька варіантів значень. Можливі значення: multiple.
- selected - застосовується лише до елементів типу: select, radio та checkbox. Визначає, чи позначений елемент за замовчуванням.
- width – Використовується тільки в елементах типу: captcha. Визначає ширину зображення у пікселах. Можливі значення: ціле число щонайменше 100.
- height – Використовується тільки в елементах типу: captcha. Визначає висоту зображення у пікселах. Можливі значення: ціле число щонайменше 50.
- onclick - використовується тільки в елементах типу: button, reset, checkbox. Визначає HTML атрибут onclick.
- onchange - використовується тільки в елементах типу: text, textarea, select. Визначає HTML атрибут onchange.
- extensions – Використовується тільки в елементах типу: file. Визначає розширення файлів доступних для завантаження перерахованих через кому. Наприклад: gif, jpg, zip
- maxsize – Використовується тільки в елементах типу: file. Визначає мексимальний розмір файлу. Приймає значення в кілобайтах та магабайтах.
Наприклад, щоб задати максимальний розмір файлу, що завантажується в 200 кілобайт потрібно написати: 200Kb. Для розміру 1 мегабайт: 1Mb.
- color - Використовується лише в елементах типу captcha. Визначає колір напису HEX. Якщо відсутня – колір генерується випадковим чином. (доданий у версії 1.0.5)
- background - Використовується лише в елементах типу captcha. Визначає колір фону у форматі HEX. Якщо відсутня – колір генерується випадковим чином. (доданий у версії 1.0.5)
Атрибути тега "option"
- label * - Визначає напис, що пояснює, біля елемента.
- Value * – Визначає варіант значення елемента.
- Selected - Якщо значення цього атрибуту дорівнює "selected", то цей варіант значення елемента буде відзначений за замовчуванням.
- Onclick - Визначає HTML атрибут onclick.
Елемент "option" функціонує лише як вміст елемента "element" типу: select, radio, checkbox.
Увага! Атрибути, що позначені знаком * є обов'язковими.
Обробка форми відбувається ввідповідно до вимог зазначених у характеристиках елементів. Дані збираються за шаблоном прописаним у мовному файлі та надсилаються на e-mail, занесений до налаштувань модуля форми.