Club Drupal

<?php

/**

 * @file

 * Stub file for bootstrap_form_element().

 */

/**

 * Returns HTML for a form element.

 *

 * Each form element is wrapped in a DIV container having the following CSS

 * classes:

 * - form-item: Generic for all form elements.

 * - form-type-#type: The internal element #type.

 * - form-item-#name: The internal form element #name (usually derived from the

 *   $form structure and set via form_builder()).

 * - form-disabled: Only set if the form element is #disabled.

 *

 * In addition to the element itself, the DIV contains a label for the element

 * based on the optional #title_display property, and an optional #description.

 *

 * The optional #title_display property can have these values:

 * - before: The label is output before the element. This is the default.

 *   The label includes the #title and the required marker, if #required.

 * - after: The label is output after the element. For example, this is used

 *   for radio and checkbox #type elements as set in system_element_info().

 *   If the #title is empty but the field is #required, the label will

 *   contain only the required marker.

 * - invisible: Labels are critical for screen readers to enable them to

 *   properly navigate through forms but can be visually distracting. This

 *   property hides the label for everyone except screen readers.

 * - attribute: Set the title attribute on the element to create a tooltip

 *   but output no label element. This is supported only for checkboxes

 *   and radios in form_pre_render_conditional_form_element(). It is used

 *   where a visual label is not needed, such as a table of checkboxes where

 *   the row and column provide the context. The tooltip will include the

 *   title and required marker.

 *

 * If the #title property is not set, then the label and any required marker

 * will not be output, regardless of the #title_display or #required values.

 * This can be useful in cases such as the password_confirm element, which

 * creates children elements that have their own labels and required markers,

 * but the parent element should have neither. Use this carefully because a

 * field without an associated label can cause accessibility challenges.

 *

 * @param array $variables

 *   An associative array containing:

 *   - element: An associative array containing the properties of the element.

 *     Properties used: #title, #title_display, #description, #id, #required,

 *     #children, #type, #name.

 *

 * @return string

 *   The constructed HTML.

 *

 * @see theme_form_element()

 *

 * @ingroup theme_functions

 */

function bootstrap_form_element(&$variables) {

  $element = &$variables['element'];

  $name = !empty($element['#name']) ? $element['#name'] : FALSE;

  $type = !empty($element['#type']) ? $element['#type'] : FALSE;

  $wrapper = isset($element['#form_element_wrapper']) ? !!$element['#form_element_wrapper'] : TRUE;

  $form_group = isset($element['#form_group']) ? !!$element['#form_group'] : $wrapper && $type && $type !== 'hidden';

  $checkbox = $type && $type === 'checkbox';

  $radio = $type && $type === 'radio';

  // Create an attributes array for the wrapping container.

  if (empty($element['#wrapper_attributes'])) {

    $element['#wrapper_attributes'] = array();

  }

  $wrapper_attributes = &$element['#wrapper_attributes'];

  // This function is invoked as theme wrapper, but the rendered form element

  // may not necessarily have been processed by form_builder().

  $element += array(

    '#title_display' => 'before',

  );

  // Add wrapper ID for 'item' type.

  if ($type && $type === 'item' && !empty($element['#markup']) && !empty($element['#id'])) {

    $wrapper_attributes['id'] = $element['#id'];

  }

  // Check for errors and set correct error class.

  if ((isset($element['#parents']) && form_get_error($element) !== NULL) || (!empty($element['#required']) && bootstrap_setting('forms_required_has_error'))) {

    $wrapper_attributes['class'][] = 'has-error';

  }

  // Add necessary classes to wrapper container.

  $wrapper_attributes['class'][] = 'form-item';

  if ($name) {

    $wrapper_attributes['class'][] = 'form-item-' . drupal_html_class($name);

  }

  if ($type) {

    $wrapper_attributes['class'][] = 'form-type-' . drupal_html_class($type);

  }

  if (!empty($element['#attributes']['disabled'])) {

    $wrapper_attributes['class'][] = 'form-disabled';

  }

  if (!empty($element['#autocomplete_path']) && drupal_valid_path($element['#autocomplete_path'])) {

    $wrapper_attributes['class'][] = 'form-autocomplete';

  }

  // Checkboxes and radios do no receive the 'form-group' class, instead they

  // simply have their own classes.

  if ($checkbox || $radio) {

    $wrapper_attributes['class'][] = drupal_html_class($type);

  }

  elseif ($form_group) {

    $wrapper_attributes['class'][] = 'form-group';

  }

  // Create a render array for the form element.

  $build = array(

    '#form_group' => $form_group,

    '#attributes' => $wrapper_attributes,

  );

  if ($wrapper) {

    $build['#theme_wrappers'] = array('container__form_element');

    // Render the label for the form element.

    $build['label'] = array(

      '#markup' => theme('form_element_label', $variables),

      '#weight' => $element['#title_display'] === 'before' ? 0 : 2,

    );

  }

  // Checkboxes and radios render the input element inside the label. If the

  // element is neither of those, then the input element must be rendered here.

  if (!$checkbox && !$radio) {

    $prefix = isset($element['#field_prefix']) ? $element['#field_prefix'] : '';

    $suffix = isset($element['#field_suffix']) ? $element['#field_suffix'] : '';

    if ((!empty($prefix) || !empty($suffix)) && (!empty($element['#input_group']) || !empty($element['#input_group_button']))) {

      if (!empty($element['#field_prefix'])) {

        $prefix = '<span class="input-group-' . (!empty($element['#input_group_button']) ? 'btn' : 'addon') . '">' . $prefix . '</span>';

      }

      if (!empty($element['#field_suffix'])) {

        $suffix = '<span class="input-group-' . (!empty($element['#input_group_button']) ? 'btn' : 'addon') . '">' . $suffix . '</span>';

      }

      // Add a wrapping container around the elements.

      $input_group_attributes = &_bootstrap_get_attributes($element, 'input_group_attributes');

      $input_group_attributes['class'][] = 'input-group';

      $prefix = '<div' . drupal_attributes($input_group_attributes) . '>' . $prefix;

      $suffix .= '</div>';

    }

    // Build the form element.

    $build['element'] = array(

      '#markup' => $element['#children'],

      '#prefix' => !empty($prefix) ? $prefix : NULL,

      '#suffix' => !empty($suffix) ? $suffix : NULL,

      '#weight' => 1,

    );

  }

  // Construct the element's description markup.

  if (!empty($element['#description'])) {

    $build['description'] = array(

      '#type' => 'container',

      '#attributes' => array(

        'class' => array('help-block'),

      ),

      '#weight' => isset($element['#description_display']) && $element['#description_display'] === 'before' ? 0 : 20,

      0 => array('#markup' => filter_xss_admin($element['#description'])),

    );

  }

  // Render the form element build array.

  return drupal_render($build);

}