Генерация форм
Функции, позволяющие выводить и обрабатывать 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. |