Разработка:moodleQuickForm — различия между версиями

Материал из DOF
Перейти к: навигация, поиск
м (Установка проверки на стороне клиента или сервера)
(Описание некоторых стандартных методов: Добавлено описание конструктора)
Строка 12: Строка 12:
 
== Правила объявления формы ==
 
== Правила объявления формы ==
 
== Описание некоторых стандартных методов ==
 
== Описание некоторых стандартных методов ==
'''Функция __construct'''($action, $customdata, $method, $target, $attributes)
+
'''Метод __construct'''($action, $customdata, $method, $target, $attributes)
  
'''Функция add_element'''
+
Этот метод вызывается когда вы создаете новый объект формы.
  
'''Функция add_group'''
+
Параметры:
 +
* ''$action'' - какая страница будет обрабатывать данные это формы. Работает аналогично <form action="...">. По умолчанию - адрес той страницы, на которой находится форма.
 +
* ''$customdata'' - дополнительные данные для формы. Эти параметры будут записаны во внутреннюю переменную '''$this->_customdata''' доступны из всех внутренних методов формы. Передать можно все что угодно, никаних ограничений нет, тип переменной - на ваше усмотрение, но если вам нужно передать несколько значений, то рекомендуется использовать объект.
 +
* ''$method'' - метод формы, GET или POST. По умолчанию POST.
 +
* ''$target'' - только для фреймов. Имя фрейма, обрабатывающего эту форму. Используется крайне редко. По умолчанию null.
 +
* ''$attributes'' - строка атрибутов для тега <form>. Будет добавлена внутрь тега. Разрешены любые атрибуты, предусмотренные стандартом HTML 4.01
  
'''Функция add_rule'''
+
'''Метод add_element'''()
  
'''Функция set_default'''
+
'''Метод add_group'''()
 +
 
 +
'''Метод add_rule'''()
 +
 
 +
'''Метод set_default'''()
  
 
== Описание всех элементов ==
 
== Описание всех элементов ==

Версия 12:00, 1 июня 2009

Общие сведения

Библиотека moodleQuickForm (она же moodleform) построена на основе библиотеки PEAR HTML_QuickForm. Описание работы всех функций moodleQuickForm следует искать именно по этой ссылке.

При помощи moodleQuickForm можно описать большинство стандартных форм. Эта библиотека значительно облегчает время и силы, потраченные на разработку формы.

Перечисление всего того, что доступно в moodleQuickForm заняло бы слишком много места, поэтому перечислим только те задачи, которые при помощи этой библиотеки решить нельзя:

  • создать форму в виде таблицы, в которой более 2-х столбцов
  • создать длинную горизонтальную форму

Внешний вид

Внешне все формы класса moodleform выглядят одинаково: это таблица из 2-х столбцов, и некоторого количества строк:

Правила объявления формы

Описание некоторых стандартных методов

Метод __construct($action, $customdata, $method, $target, $attributes)

Этот метод вызывается когда вы создаете новый объект формы.

Параметры:

  • $action - какая страница будет обрабатывать данные это формы. Работает аналогично <form action="...">. По умолчанию - адрес той страницы, на которой находится форма.
  • $customdata - дополнительные данные для формы. Эти параметры будут записаны во внутреннюю переменную $this->_customdata доступны из всех внутренних методов формы. Передать можно все что угодно, никаних ограничений нет, тип переменной - на ваше усмотрение, но если вам нужно передать несколько значений, то рекомендуется использовать объект.
  • $method - метод формы, GET или POST. По умолчанию POST.
  • $target - только для фреймов. Имя фрейма, обрабатывающего эту форму. Используется крайне редко. По умолчанию null.
  • $attributes - строка атрибутов для тега <form>. Будет добавлена внутрь тега. Разрешены любые атрибуты, предусмотренные стандартом HTML 4.01

Метод add_element()

Метод add_group()

Метод add_rule()

Метод set_default()

Описание всех элементов

Заголовок формы

Этот заголовок будет говорить об общем содержании данных в форме. Также он используется в случае, когда вам нужно разбить форму на несколько частей.

Код:

   $mform->addElement('header','имя_html-элемента', 'Текст заголовка');

Текстовое пояснение

Поле select

Элемент text

Элемент radio

Элемент checkbox

Элемент textarea

Элемент hidden

Элемент dateselector

Добавление дополнительных данных

Установка обязательных полей

Установка дополнительных полей

Установка проверки на стороне клиента или сервера

По умолчанию все данные из формы подлежат проверке на стороне сервера. Существует возможность добавить проверку на стороне клиента. Не забывайте при этом, что эти данные нужно потом все равно еще раз проверить на стороне сервера, так как всегда существует возможность послать данные в обход формы.

Проверка на стороне сервера

Проверка на стороне клиента

Установка зависимых полей