Функции, позволяющие выводить и обрабатывать HTML формы.
Друпал использует эти функции для обеспечения единого представления и обработки форм, в то же время упрощая и уменьшая объем HTML-кода, который должен генерироваться сторонними модулями.
Функция drupal_get_form() обеспечивает автоматическое отображение, извлечение информации и обработку результатов форм. Например:
// Показать форму регистрации.
$output = drupal_get_form('user_register');
Формы могут строится и отправляться программно, без пользовательского ввода, при помощи функцииdrupal_execute().
Более подробно о работе форм, а также форматах и структуре массивов, которые используются для определения форм, можно прочесть в коротком введении и справочнике по Forms API.
Извлекает форму по form_id, заполняет ее значениями из $form_state['values'], обрабатывает, и возвращает ошибки обработки этой формы. Эта функция — аналог drupal_get_form(), используемый для программной работы с формами.
Получает форму из функции-конструктора или извлекает её из кеша, если форма была сформирована на предыдущей загрузке страницы. Далее функция проводит проверку и обработку данных, и, если необходимо формирует её HTML-код.
Подготавливает полный массив формы, добавляя в него недостающие значения по-умолчанию, вызывая нужные хуки, а также, опционально, выставляя токены валидации для некоторых полей, чтобы обезопасить форму от несанкционированных вмешательств.
A helper function used to execute custom validation and submission handlers for a given form. Button-specific handlers are checked first. If none exist, the function falls back to form-level handlers.
Add AHAH information about a form element to the page to communicate with javascript. If #ahah[path] is set on an element, this additional javascript is added to the page header to attach the AHAH behaviors. See ahah.js for more information.
Populate the #value and #name properties of input elements so they can be processed and rendered. Also, execute any #process handlers attached to a specific element.
In IE, if only one submit button is present, AND the enter key is used to submit the form, no form value is sent for it and our normal button detection code will never detect a match. We call this function after all other button-detection is complete…
Performs validation on form elements. First ensures required fields are completed, #maxlength is not exceeded, and selected options were in the list of options given to the user. Then calls user-defined validators.