Drupal 7 Module Development

Creating New Fields
}
$row[] = t('@value (%units)', array(
'@value' => $item['depth'],
'%units' => dimfield_units($item['units']),
));
}
else {
$row[] = $item['depth'];
}
}
if ($settings['units_as'] == 'column') {
$row[] = dimfield_units($item['units']);
}
$rows[] = $row;
$header = array(t('Height'), t('Width'));
if ($field['settings']['num_dimensions'] == 3) {
$header[] = t('Depth');
}
if ($settings['units_as'] == 'column') {
$header[] = t('Units');
}
}
$element = array(
'#theme' => 'table',
'#rows' => $rows,
'#header' => $header,
);
break;
}
return $element;
In this formatter, we build up a series of rows of data consisting of height, width,
and depth if applicable. Each row is an array, and then we have an array of arrays to
give us a table structure. That array we assign to an element that will get rendered
as a table, as defined by the #theme key. Because Drupal defines a theme_table()
function, that data will get passed to that function when the element is rendered and
returned as an HTML table.
Note also that we're changing how the table gets built based on the settings we
configured a moment ago. There may or may not be a column dedicated to units,
and we may or may not display the units as part of each cell. Due to the fact that a
settings value is exclusive, we don't need to worry about those two colliding as
both can never be true.
[ 204 ]