function field_widget_instance

7.x field_widget_instance($element, $form_state)

Retrieves the instance definition array for a widget's helper callbacks.

Widgets helper element callbacks (such as #process, #element_validate, #value_callback, ...) should use field_widget_field() and field_widget_instance() instead of field_info_field() and field_info_instance() when they need to access field or instance properties. See hook_field_widget_form() for more details.


$element: The structured array for the widget.

$form_state: The form state.

Return value

The $instance definition array for the current widget.

See also



3 calls to field_widget_instance()
file_field_widget_process in drupal/modules/file/
An element #process callback for the file_generic field type.
image_field_widget_process in drupal/modules/image/
An element #process callback for the image_image field type.
number_field_widget_validate in drupal/modules/field/modules/number/number.module
FAPI validation of an individual number element.


drupal/modules/field/, line 601
Field forms management.


function field_widget_instance($element, $form_state) {
  $field_state = field_form_get_state($element['#field_parents'], $element['#field_name'], $element['#language'], $form_state);
  return $field_state['instance'];