Form generation
Функции, позволяющие выводить и обрабатывать HTML формы.
Друпал использует эти функции обеспечения последовательности представления и обработки форм, в то же время упрощает код HTML и уменьшает его объем, и все это делается за счет генерируемых модулей.
Функция drupal_get_form()
автоматически обеспечивает отображение HTML-форм, извлечение информации из них и обработку результатов. Например:
// Display the user registration form. $output = drupal_get_form('user_register');
Формы могут быть созданы и выведины без программирования, и пользователи смогут ими пользоваться с помощью функции drupal_execute()
.
Информацию о формате структур, используемых для определения форм, и более детальные пояснения по Forms API смотрите в справочнике и быстром введении.
Функции
Имя | Описание |
---|---|
checkboxes_value includes/form.inc | Helper function to load value from default value for checkboxes. |
date_validate includes/form.inc | Проверка корректности ввода данных типа date. Запрет ввода дат типа 31 Февраля, 2006. |
drupal_execute includes/form.inc | Извлекает форму по form_id , заполняет ее значениями из $form_values,
обрабатывает, и возвращает ошибки обработки этой формы. Эта функция — аналог drupal_get_form(), используемый для программной работы с формами. |
drupal_get_form includes/form.inc | Запрашивает форму из функции создания формы, возвращает её для обработки, передаёт значения формы в то место, где они требуются. В сценариях, в которых используется многошаговая структура использования форм, это позволяет управлять правильностью передачи соответствующих данных с предыдущего шага работы сценария, делать необходимый следующий шаг для отображения результата. |
drupal_prepare_form includes/form.inc | Подготавливает полный массив формы, добавляя в него недостающие значения по-умолчанию, вызывая нужные хуки, а также, опционально, выставляя токены валидации для некоторых полей, чтобы обезопасить форму от несанкционированных вмешательств. |
drupal_process_form includes/form.inc | This function is the heart of form API. The form gets built, validated and in appropriate cases, submitted. |
drupal_redirect_form includes/form.inc | Перенаправляет пользователя на URL после обработки формы. |
drupal_render_form includes/form.inc | Renders a structured form array into themed HTML. |
drupal_retrieve_form includes/form.inc | Возвращает структурированный массив, определяющий форму. |
drupal_submit_form includes/form.inc | Processes user-submitted form data from a global variable using the submit functions defined in a structured form array. |
drupal_validate_form includes/form.inc | Validates user-submitted form data from a global variable using the validate functions defined in a structured form array. |
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 | Adds some required properties to each form element, which are used internally in the form API. This function also automatically assigns the value property from the $edit array, provided the element doesn't already have an assigned value. |
form_clean_id includes/form.inc | Remove invalid characters from an HTML ID attribute string. |
form_error includes/form.inc | Flag an element as having an error. |
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_error includes/form.inc | Устанавливает ошибку для указанного элемента формы. |
form_set_value includes/form.inc | Use this function to make changes to form values in the form validate phase, so they will be available in the submit phase in $form_values. |
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_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_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_textarea includes/form.inc | Форматирует многострочное текстовое поле ввода для формы. |
theme_textfield includes/form.inc | Форматирует однострочное текстовое поле ввода. |
weight_value includes/form.inc | If no default value is set for weight select boxes, use 0. |
_drupal_clean_form_sessions includes/form.inc | Remove form information that's at least a day old from the $_SESSION['form'] array. |
_element_info includes/form.inc | Retrieve the default properties for the defined element type. |
_form_set_class includes/form.inc | Sets a form element's class attribute. |
_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. |