Разработка:moodleQuickForm — различия между версиями
Ilya (обсуждение | вклад) м (→Проверка на стороне сервера) |
Ilya (обсуждение | вклад) м |
||
| Строка 11: | Строка 11: | ||
== Правила объявления формы == | == Правила объявления формы == | ||
| − | == Описание | + | == Описание стандартных методов moodleform == |
===== __construct($action, $customdata, $method, $target, $attributes, $editable) ===== | ===== __construct($action, $customdata, $method, $target, $attributes, $editable) ===== | ||
| − | |||
Этот метод вызывается когда вы создаете новый объект формы. | Этот метод вызывается когда вы создаете новый объект формы. | ||
| Строка 25: | Строка 24: | ||
===== display() ===== | ===== display() ===== | ||
| − | |||
Вывести форму на экран. Вызывается непосредственно в том месте, где должна быть форма. | Вывести форму на экран. Вызывается непосредственно в том месте, где должна быть форма. | ||
===== get_data($slashed) ===== | ===== get_data($slashed) ===== | ||
| − | + | Получить данные формы после всех проверок на стороне клиента и сервера. | |
| − | Получить данные формы после всех проверок на | ||
* $slashed - экранировать кавычки. По умолчанию true. | * $slashed - экранировать кавычки. По умолчанию true. | ||
===== get_submitted_data($slashed) ===== | ===== get_submitted_data($slashed) ===== | ||
| − | |||
Получить данные из формы, к которым еще не применены никакие проверки. | Получить данные из формы, к которым еще не применены никакие проверки. | ||
* $slashed - экранировать кавычки. По умолчанию true. | * $slashed - экранировать кавычки. По умолчанию true. | ||
| Строка 47: | Строка 43: | ||
===== is_submitted() ===== | ===== is_submitted() ===== | ||
| − | + | Возвращает ''true'' если форма подтверждена, и ''false'' в противном случае. | |
| − | Возвращает true если форма подтверждена, | ||
===== is_cancelled() ===== | ===== is_cancelled() ===== | ||
| − | + | Возвращает ''true'' если форма отменена, и ''false'' в противном случае. | |
| − | Возвращает true если форма отменена. | ||
| Строка 61: | Строка 55: | ||
* $files - массив загруженных в форму файлов. Имеет вид array('имя_поля' => 'путь_к_временному_файлу') | * $files - массив загруженных в форму файлов. Имеет вид array('имя_поля' => 'путь_к_временному_файлу') | ||
Должен возвращать массив вида array('имя_поля' => 'текст_сообщения_об_ошибке'). По умолчанию возвращает пустой массив. | Должен возвращать массив вида array('имя_поля' => 'текст_сообщения_об_ошибке'). По умолчанию возвращает пустой массив. | ||
| + | |||
| + | ===== setAdvanced($elementName, $advanced=true) ===== | ||
| + | |||
== Элементы формы == | == Элементы формы == | ||
Версия 13:39, 1 июня 2009
Содержание
- 1 Общие сведения
- 2 Внешний вид
- 3 Правила объявления формы
- 4 Описание стандартных методов moodleform
- 4.1 __construct($action, $customdata, $method, $target, $attributes, $editable)
- 4.2 display()
- 4.3 get_data($slashed)
- 4.4 get_submitted_data($slashed)
- 4.5 add_element()
- 4.6 add_group()
- 4.7 add_rule()
- 4.8 set_default()
- 4.9 is_submitted()
- 4.10 is_cancelled()
- 4.11 validation($data, $files)
- 4.12 setAdvanced($elementName, $advanced=true)
- 5 Элементы формы
- 6 Добавление дополнительных данных
- 7 Установка обязательных полей
- 8 Установка дополнительных полей
- 9 Установка проверки на стороне клиента или сервера
- 10 Установка зависимых полей
Общие сведения
Библиотека moodleQuickForm (она же moodleform) построена на основе библиотеки PEAR HTML_QuickForm. Описание работы всех функций moodleQuickForm следует искать именно по этой ссылке.
При помощи moodleQuickForm можно описать большинство стандартных форм. Эта библиотека значительно облегчает время и силы, потраченные на разработку формы.
Перечисление всего того, что доступно в moodleQuickForm заняло бы слишком много места, поэтому перечислим только те задачи, которые при помощи этой библиотеки решить нельзя:
- создать форму в виде таблицы, в которой более 2-х столбцов
- создать длинную горизонтальную форму
Внешний вид
Внешне все формы класса moodleform выглядят одинаково: это таблица из 2-х столбцов, и некоторого количества строк:
Правила объявления формы
Описание стандартных методов moodleform
__construct($action, $customdata, $method, $target, $attributes, $editable)
Этот метод вызывается когда вы создаете новый объект формы.
Параметры:
- $action - какая страница будет обрабатывать данные это формы. Работает аналогично <form action="...">. По умолчанию - адрес той страницы, на которой находится форма.
- $customdata - дополнительные данные для формы. Эти параметры будут записаны во внутреннюю переменную $this->_customdata доступны из всех внутренних методов формы. Передать можно все что угодно, никаних ограничений нет, тип переменной - на ваше усмотрение, но если вам нужно передать несколько значений, то рекомендуется использовать объект. По умолчанию null.
- $method - метод формы, GET или POST. По умолчанию POST.
- $target - только для фреймов. Имя фрейма, обрабатывающего эту форму. Используется крайне редко. По умолчанию null.
- $attributes - строка атрибутов для тега <form>. Будет добавлена внутрь тега. Разрешены любые атрибуты, предусмотренные стандартом HTML 4.01. По умолчанию пустая строка.
- $editable - доступна ли форма для редактирования. По умолчанию true (в противном случае все поля в форме будут неактивными).
display()
Вывести форму на экран. Вызывается непосредственно в том месте, где должна быть форма.
get_data($slashed)
Получить данные формы после всех проверок на стороне клиента и сервера.
- $slashed - экранировать кавычки. По умолчанию true.
get_submitted_data($slashed)
Получить данные из формы, к которым еще не применены никакие проверки.
- $slashed - экранировать кавычки. По умолчанию true.
add_element()
add_group()
add_rule()
set_default()
is_submitted()
Возвращает true если форма подтверждена, и false в противном случае.
is_cancelled()
Возвращает true если форма отменена, и false в противном случае.
validation($data, $files)
Вызывается автоматически, после отправки данных на сервер. Используется для дополнительной проверки данных на стороне сервера. Все необходимые проверки должны быть проведены именно здесь.
- $data - массив вида array('имя_поля' => 'значение') из отправленных данных
- $files - массив загруженных в форму файлов. Имеет вид array('имя_поля' => 'путь_к_временному_файлу')
Должен возвращать массив вида array('имя_поля' => 'текст_сообщения_об_ошибке'). По умолчанию возвращает пустой массив.
setAdvanced($elementName, $advanced=true)
Элементы формы
Заголовок формы
Этот заголовок будет говорить об общем содержании данных в форме. Также он используется в случае, когда вам нужно разбить форму на несколько частей.
Код:
$mform->addElement('header','имя_html-элемента', 'Текст заголовка');
Текстовое пояснение
Поле select
Элемент text
Элемент radio
Элемент checkbox
Элемент textarea
Элемент hidden
Элемент dateselector
Добавление дополнительных данных
Установка обязательных полей
Установка дополнительных полей
Установка проверки на стороне клиента или сервера
По умолчанию все данные из формы подлежат проверке на стороне сервера. Существует возможность добавить проверку на стороне клиента. Не забывайте при этом, что эти данные нужно потом все равно еще раз проверить на стороне сервера, так как всегда существует возможность послать данные в обход формы.
Проверка на стороне сервера
Если вам требуется дополнительная проверка данных на стороне клиента, то используйте стандартный метод validation($data, $files). Любые другие способы проверки данных после формы объявляются богопротивной ересью, а нарушители сжигаются на костре.
