form.inc

Version 1.419 (checked in on 2009/12/14 at 13:51:56 by dries)

Functions

NameDescription
batch_getRetrieves the current batch.
batch_processProcesses the batch.
batch_setOpens a new batch.
date_validateValidates the date type to stop dates like February 30, 2006.
drupal_build_formBuild and process a form based on a form id.
drupal_form_submitRetrieves a form using a form_id, populates it with $form_state['values'], processes it, and returns any validation errors encountered. This function is the programmatic counterpart to drupal_get_form().
drupal_get_formWrapper for drupal_build_form() for use when $form_state is not needed.
drupal_prepare_formPrepares a structured form array by adding required elements, executing any hook_form_alter functions, and optionally inserting a validation token to prevent tampering.
drupal_process_formProcesses a form submission.
drupal_rebuild_formRetrieves a form, caches it and processes it again.
drupal_redirect_formRedirects the user to a URL after a form has been processed.
drupal_retrieve_formRetrieves the structured array that defines a given form.
drupal_validate_formValidates user-submitted form data from the $form_state using the validate functions defined in a structured form array.
form_builderWalk through the structured form array, adding any required properties to each element and mapping the incoming input data to the proper elements. Also, execute any #process handlers attached to a specific element.
form_clear_errorClear all errors against all form elements made by form_set_error().
form_errorFlag an element as having an error.
form_execute_handlersA 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_get_cacheFetch a form from cache.
form_get_errorReturn the error message filed against the form with the specified name.
form_get_errorsReturn an associative array of all errors.
form_get_optionsTraverses a select element's #option array looking for any values that hold the given key. Returns an array of indexes that match.
form_options_flatten
form_pre_render_conditional_form_elementAdd form_element theming to an element if title or description is set.
form_pre_render_fieldsetAdds members of this group as actual elements for rendering.
form_process_checkboxes
form_process_containerProcesses a container element.
form_process_dateRoll out a single date element.
form_process_fieldsetAdds fieldsets to the specified group or adds group members to this fieldset.
form_process_password_confirmExpand a password_confirm field into two text boxes.
form_process_radiosRoll out a single radios element to a list of radios, using the options array as index.
form_process_tableselectCreate the correct amount of checkbox or radio elements to populate the table.
form_process_text_formatAdd text format selector to text elements with the #text_format property.
form_process_vertical_tabsCreates a group formatted as vertical tabs.
form_process_weightExpand weight elements into selects.
form_select_optionsConvert a select form element's options array into an HTML.
form_set_cacheStore a form in the cache.
form_set_errorFiles an error against a form element.
form_set_valueChange submitted form values during form validation.
form_state_defaultsRetrieve default values for the $form_state array.
form_state_keys_no_cacheReturns an array of $form_state keys that shouldn't be cached.
form_state_values_cleanRemoves internal Form API elements and buttons from submitted form values.
form_type_checkboxes_valueHelper function to determine the value for a checkboxes form element.
form_type_checkbox_valueHelper function to determine the value for a checkbox form element.
form_type_image_button_valueHelper function to determine the value for an image button form element.
form_type_password_confirm_valueHelper function to determine the value for a password_confirm form element.
form_type_select_valueHelper function to determine the value for a select form element.
form_type_textfield_valueHelper function to determine the value for a textfield form element.
form_type_token_valueHelper function to determine the value for form's token value.
map_monthHelper function for usage with drupal_map_assoc to display month names.
password_confirm_validateValidate password_confirm element.
theme_buttonTheme a button form element.
theme_checkboxTheme a checkbox form element.
theme_checkboxesTheme a set of checkbox form elements.
theme_containerAdds a container for grouped items
theme_dateTheme a date selection form element.
theme_fieldsetTheme a fieldset form element.
theme_fileTheme a file upload form element.
theme_formTheme a form.
theme_form_elementTheme a form element.
theme_form_element_labelTheme a form element label and required marker.
theme_form_required_markerTheme the marker for required form elements.
theme_hiddenTheme a hidden form element.
theme_image_buttonTheme a image button form element.
theme_passwordTheme a password form element.
theme_radioTheme a radio button form element.
theme_radiosTheme a set of radio button form elements.
theme_selectTheme select form element.
theme_submitTheme a submit button form element.
theme_tableselectFormat a table with radio buttons or checkboxes.
theme_textareaTheme a textarea form element.
theme_textfieldTheme a textfield form element.
theme_text_format_wrapperTheme a text format form element.
theme_vertical_tabsMakes the element's children fieldsets be vertical tabs.
weight_valueIf no default value is set for weight select boxes, use 0.
_form_builder_handle_input_elementPopulate the #value and #name properties of input elements so they can be processed and rendered.
_form_builder_ie_cleanupIn 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_clickedHelper function to handle the sometimes-convoluted logic of button click detection.
_form_set_classSets a form element's class attribute.
_form_set_valueHelper function for form_set_value() and _form_builder_handle_input_element().
_form_validatePerforms 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.
Login or register to post comments
 
 

All source code and documentation on this site is released under the terms of the GNU General Public License, version 2 and later. Drupal is a registered trademark of Dries Buytaert.