Распечатать статью

Генерация форм

Функции, позволяющие выводить и обрабатывать HTML формы.

Друпал использует эти функции для обеспечения единого представления и обработки форм, в то же время упрощая и уменьшая объем HTML-кода, который должен генерироваться сторонними модулями.

Функция drupal_get_form() обеспечивает автоматическое отображение, извлечение информации и обработку результатов форм. Например:

// Показать форму регистрации.
$output = drupal_get_form('user_register');

Формы могут строится и отправляться программно, без пользовательского ввода, при помощи функцииdrupal_execute().

Более подробно о работе форм, а также форматах и структуре массивов, которые используются для определения форм, можно прочесть в коротком введении и справочнике по Forms API.

Функции

Имя Описание
date_validate
includes/form.inc
Проверка корректности ввода данных типа date. Запрет ввода дат типа 31 Февраля, 2006.
drupal_execute
includes/form.inc
Извлекает форму по form_id, заполняет ее значениями из $form_state['values'], обрабатывает, и возвращает ошибки обработки этой формы. Эта функция — аналог drupal_get_form(), используемый для программной работы с формами.
drupal_get_form
includes/form.inc
Получает форму из функции-конструктора или извлекает её из кеша, если форма была сформирована на предыдущей загрузке страницы. Далее функция проводит проверку и обработку данных, и, если необходимо формирует её HTML-код.
drupal_prepare_form
includes/form.inc
Подготавливает полный массив формы, добавляя в него недостающие значения по-умолчанию, вызывая нужные хуки, а также, опционально, выставляя токены валидации для некоторых полей, чтобы обезопасить форму от несанкционированных вмешательств.
drupal_process_form
includes/form.inc
Эта функция является основной в Forms API. Предназначена для построения формы и проверки формы на соответствие требованиям и обработки результатов.
drupal_rebuild_form
includes/form.inc
Retrieves a form, caches it and processes it with an empty $_POST.
drupal_redirect_form
includes/form.inc
Перенаправляет пользователя на URL после обработки формы.
drupal_render_form
includes/form.inc
Генерирует темизированный HTML-код из структурированного массива формы.
drupal_retrieve_form
includes/form.inc
Возвращает структурированный массив, определяющий данную форму.
drupal_validate_form
includes/form.inc
Проверяет отправленные пользователем данные формы из $form_state, используя функции проверки, заданные в структурированном массиве формы.
expand_date
includes/form.inc
Roll out a single date element.
expand_password_confirm
includes/form.inc
Expand a password_confirm field into two text boxes.
expand_radios
includes/form.inc
Превращает элемент radios («список переключателей») в список еденичных элементов radio («переключатель»).
form_builder
includes/form.inc
Walk through the structured form array, adding any required properties to each element and mapping the incoming $_POST data to the proper elements.
form_clean_id
includes/form.inc
Prepare an HTML ID attribute string for a form item.
form_error
includes/form.inc
Устанавливает флаг наличия ошибки для $element.
form_execute_handlers
includes/form.inc
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.
form_expand_ahah
includes/form.inc
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.
form_get_cache
includes/form.inc
Получает форму из кэша.
form_get_error
includes/form.inc
Return the error message filed against the form with the specified name.
form_get_errors
includes/form.inc
Возвращает ассоциативный массив всех ошибок на форме.
form_get_options
includes/form.inc
Traverses a select element’s #option array looking for any values that hold the given key. Returns an array of indexes that match.
form_set_cache
includes/form.inc
Сохраняет форму в кэше.
form_set_error
includes/form.inc
Устанавливает ошибку для указанного элемента формы.
form_set_value
includes/form.inc
Изменяет отправленные значения формы во время цикла обработки формы.
form_type_checkboxes_value
includes/form.inc
Helper function to determine the value for a checkboxes form element.
form_type_checkbox_value
includes/form.inc
Helper function to determine the value for a checkbox form element.
form_type_image_button_value
includes/form.inc
Helper function to determine the value for an image button form element.
form_type_password_confirm_value
includes/form.inc
Helper function to determine the value for a password_confirm form element.
form_type_select_value
includes/form.inc
Helper function to determine the value for a select form element.
form_type_textfield_value
includes/form.inc
Helper function to determine the value for a textfield form element.
form_type_token_value
includes/form.inc
Helper function to determine the value for form’s token value.
map_month
includes/form.inc
Вспомогательная функция используемая с drupal_map_assoc для показа названий месяцев.
password_confirm_validate
includes/form.inc
Validate password_confirm element.
process_weight
includes/form.inc
Expand weight elements into selects.
theme_button
includes/form.inc
Форматирует кнопку для формы.
theme_checkbox
includes/form.inc
Темизирует чекбокс.
theme_checkboxes
includes/form.inc
Изменяет стиль сразу нескольких чекбоксов.
theme_date
includes/form.inc
Форматирует дату выбранного элемента.
theme_fieldset
includes/form.inc
Форматирует группу элементов формы
theme_file
includes/form.inc
Форматирует поле загрузки файла.
theme_form
includes/form.inc
Темизирует форму.
theme_form_element
includes/form.inc
Возвращает темизированный элемент формы.
theme_hidden
includes/form.inc
Форматирует скрытое поле формы.
theme_image_button
includes/form.inc
Темизирует кнопку-картинку формы.
theme_item
includes/form.inc
Возвращает темизированный элемент формы.
theme_password
includes/form.inc
Форматирует поле ввода пароля.
theme_password_confirm
includes/form.inc
Форматирует пункт подтверждения пароля.
theme_radio
includes/form.inc
Форматирует одиночный переключатель (радио-кнопку) для их группы.
theme_radios
includes/form.inc
Форматирует сразу несколько радио-кнопок.
theme_select
includes/form.inc
Format a dropdown menu or scrolling selection box.
theme_submit
includes/form.inc
Форматирует кнопку отправки формы.
theme_textarea
includes/form.inc
Форматирует многострочное текстовое поле ввода для формы.
theme_textfield
includes/form.inc
Форматирует однострочное текстовое поле ввода.
theme_token
includes/form.inc
Темизирует токен формы.
weight_value
includes/form.inc
If no default value is set for weight select boxes, use 0.
_element_info
includes/form.inc
Retrieve the default properties for the defined element type.
_form_builder_handle_input_element
includes/form.inc
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.
_form_builder_ie_cleanup
includes/form.inc
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…
_form_button_was_clicked
includes/form.inc
Helper function to handle the sometimes-convoluted logic of button click detection.
_form_set_class
includes/form.inc
Устанавливает значение атрибута class для элемента формы.
_form_set_value
includes/form.inc
Helper function for form_set_value().
_form_validate
includes/form.inc
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.

Источник: drupal.ru

Вы можете оставить комментарий, или обратную ссылку на Ваш сайт.

Оставить комментарий

Похожие статьи