You are here

function rolereference_autocomplete_process in Role Reference 6

Process an individual element.

Build the form element. When creating a form using FAPI #process, note that $element['#value'] is already set.

1 string reference to 'rolereference_autocomplete_process'
rolereference_elements in ./rolereference.module
Implementation of FAPI hook_elements().

File

./rolereference.module, line 528
Defines a field type for referencing a role. Based almost entirely on nodereference and userreference modules.

Code

function rolereference_autocomplete_process($element, $edit, $form_state, $form) {

  // The rolereference autocomplete widget doesn't need to create its own
  // element, it can wrap around the text_textfield element and add an autocomplete
  // path and some extra processing to it.
  // Add a validation step where the value can be unwrapped.
  $field_key = $element['#columns'][0];
  $element[$field_key] = array(
    '#type' => 'text_textfield',
    '#default_value' => isset($element['#value']) ? $element['#value'] : '',
    '#autocomplete_path' => 'rolereference/autocomplete/' . $element['#field_name'],
    // The following values were set by the content module and need
    // to be passed down to the nested element.
    '#title' => $element['#title'],
    '#required' => $element['#required'],
    '#description' => $element['#description'],
    '#field_name' => $element['#field_name'],
    '#type_name' => $element['#type_name'],
    '#delta' => $element['#delta'],
    '#columns' => $element['#columns'],
  );
  if (empty($element[$field_key]['#element_validate'])) {
    $element[$field_key]['#element_validate'] = array();
  }
  array_unshift($element[$field_key]['#element_validate'], 'rolereference_autocomplete_validate');

  // Used so that hook_field('validate') knows where to flag an error.
  $element['_error_element'] = array(
    '#type' => 'value',
    // Wrapping the element around a text_textfield element creates a
    // nested element, so the final id will look like 'field-name-0-rid-rid'.
    '#value' => implode('][', array_merge($element['#parents'], array(
      $field_key,
      $field_key,
    ))),
  );
  return $element;
}