Drupal 7 Module Development

Chapter 7
$element['width'] = array(
'#type' => 'textfield',
'#title' => t('Width'),
'#default_value' => isset($items[$delta]['width']) ?
$items[$delta]['width'] : NULL,
) + $base;
if ($field['settings']['num_dimensions'] == 3) {
$element['depth'] = array(
'#type' => 'textfield',
'#title' => t('Depth'),
'#default_value' => isset($items[$delta]['depth']) ?
$items[$delta]['depth'] : NULL,
) + $base;
}
}
$element['units'] = array(
'#type' => 'select',
'#title' => t('Units'),
'#default_value' => isset($items[$delta]['units']) ?
$items[$delta]['units'] : NULL,
'#options' => dimfield_units(),
);
}
return $element;
Once again, notice that we're checking for which widget we are using in this
callback, since both widgets will use the same callback. Our parameters include
the form that this widget will be added to and its $form_state. Although they are
passed by reference, we will not actually be modifying them directly (most of the
time). Instead, we will return an $element Form API fragment that Drupal will
insert into the form in the correct place. The $element that is passed in contains basic
information about the widget itself, which we will store in our own variable to pass
forward. The Form API will ignore properties it doesn't recognize, but that data will
be available to us later.
[ 193 ]