Модуль simpleForm

Модуль simpleForm - это уникальный модуль работающий на технологии AJAX и позволяющий вам создать практически любую форму на вашем сайте без установки дополнительных плагинов, компонентов, модулей. Все построение формы сводится к написанию структуры вашей формы специальными тэгами. Пусть вас не пугает слово "тэг", т.к. в данном случае их всего 3 штуки:

• group - тэг определяющий группу элементов (fieldset).
• element - тэг элемента формы (input, select, textarea...).
• option - тэг одного из нескольких вариантов значения тэга element (его можно сравнить с option в HTML).

У каждого из этих тэгов есть определенный набор атрибутов. Атрибуты могут быть как обязательные так и не обязательные.

Атрибуты тэга "group"

• name * - Определяет название группы.

Атрибуты тэга "element"

• type * - Определяет тип элемента. Возможные значения: text, textarea, select, radio, button, submit, reset, checkbox, captcha.
• label - Определяет поясняющую надпись возле элемента.
• required - Если значение этого атрибута равно "required", то заполнение данного элемента будет обязательным для пользователя.
• regex - Значением этого атрибута может быть регулярное выражение для проверки правильности заполнения элемента, у которого назначен этот атрибут.
• error - Значением этого атрибута может быть текст сообщения об ошибки вызванной незаплнением элемента, у которого определен этот атрибут и атрибут required имеет значение "required", либо введенные данные не прошли проверку регулярного выражения.
• value - Значение этого атрибута является значением элемента по-умолчанию.
• class - Если этот атрибут не пустой, то элементу будет задан CSS класс из значения этого атрибута.
• multiple - Данный атрибут может использоваться только в элементе с типом: select. Определяет можно ли выбрать несколько вариантов значений. Возможные значения: multiple.
• width - Используется только в элементах типа: captcha. Определяет ширину изображения в пикселах. Возможные значения: целое число не менее 100.
• height - Используется только в элементах типа: captcha. Определяет высоту изображения в пикселах. Возможные значения: целое число не менее 50.
• onclick - Используется только в элементах типа: button, submit, reset. Определяет HTML атрибут onclick.

Атрибуты тэга "option"

• value * - Определяет вариант значения элемента.
• selected - Если значение этого атрибута равно "selected", то данный вариант значения элемента будет отмечен по-умолчанию.

Тэг "option" используется только как содержимое тэга "element" типа: select, radio, checkbox. Кроме атрибутов данный тэг имеет содержимое, которое является аналогом атрибута "label" у тэга "element", т.е. определяет поясняющую надпись по данному варианту значения элемента.

Внимание! Атрибуты, отмеченные знаком * являются обязательными атрибутами.

Обработка формы происходит в соответствии с требованиями указанными в параметрах элементов. Данные собираются по шаблону прописанному в языковом файле и отправляются на e-mail, указанный в настройках модуля формы.

Пример кода формы simpleForm:

<element label="Ваше имя" type="text" required="required" error="Введите ваше имя" />
<element label="Ваше сообщение" type="textarea" required="required" error="Введите ваше сообщение" />
<element label="simpleForm - это:" type="select">
   <option value="Модуль">Модуль</option>
   <option value="Компонент">Компонент</option>
   <option value="Плагин">Плагин</option>
   <option value="Не знаю">Не знаю</option>
</element>
<element type="submit" value="Отправить" />

Данное расширение работает только в среде Joomla! 1.5