_form_button_was_clicked

  1. drupal
    1. 6
    2. 8
    3. 7
Versions
6 _form_button_was_clicked($form)
8 – 7 _form_button_was_clicked($element, &$form_state)

Helper function to handle the convoluted logic of button click detection.

This detects button controls that trigger a form submission by being clicked and having the click processed by the browser rather than being captured by JavaScript. Essentially, it detects if the button's name and value are part of the POST data, but with extra code to deal with the convoluted way in which browsers submit data for image button clicks.

This does not detect button clicks processed by Ajax (that is done in _form_element_triggered_scripted_submission()) and it does not detect form submissions from Internet Explorer in response to an ENTER key pressed in a textfield (form_builder() has extra code for that).

Because this function contains only part of the logic needed to determine $form_state['triggering_element'], it should not be called from anywhere other than within the Form API. Form validation and submit handlers needing to know which button was clicked should get that information from $form_state['triggering_element'].

Related topics

▾ 1 function calls _form_button_was_clicked()

_form_builder_handle_input_element in includes/form.inc
Populate the #value and #name properties of input elements so they can be processed and rendered.

Code

includes/form.inc, line 2071

<?php
function _form_button_was_clicked($element, &$form_state) {
  // First detect normal 'vanilla' button clicks. Traditionally, all
  // standard buttons on a form share the same name (usually 'op'),
  // and the specific return value is used to determine which was
  // clicked. This ONLY works as long as $form['#name'] puts the
  // value at the top level of the tree of $_POST data.
  if (isset($form_state['input'][$element['#name']]) && $form_state['input'][$element['#name']] == $element['#value']) {
    return TRUE;
  }
  // When image buttons are clicked, browsers do NOT pass the form element
  // value in $_POST. Instead they pass an integer representing the
  // coordinates of the click on the button image. This means that image
  // buttons MUST have unique $form['#name'] values, but the details of
  // their $_POST data should be ignored.
  elseif (!empty($element['#has_garbage_value']) && isset($element['#value']) && $element['#value'] !== '') {
    return TRUE;
  }
  return FALSE;
}
?>