Customising the labels on radio-buttons
This blog post is more than 10 years old, so the content may be out of date.
Thought I'd quickly blog about this whilst this is fresh in my head!
Sometimes you want to add detail to a set of radio-buttons - e.g. you may want to show an example image below the radio-button's label:
Choose cable connection
( ) VGA
[ pic of VGA cable ]
( ) DVI
[ pic of DVI cable ]
( ) DisplayPort
[ pic of DisplayPort cable ]
You would usually start with this Drupal code:
<?php
$form['cable_type'] = array(
'#type' => 'radios',
'#title' => t('Choose cable connection'),
'#options' => array('vga' => t('VGA'),
'dvi' => t('DVI'),
'displayport' => t('DisplayPort'),
),
);The problem is that you can add a #description property to the set of radio-buttons, but not to individual radio buttons.
The solution is to use an after-build handler to inject the description.
<?php
/**
* Implementation of hook_form_alter().
*/
function foo_form_alter(&$form, &$form_state, $form_id) {
if($form_id == 'xxx_node_form') {
// Add a custom after-build handler to the cable-type element.
$form['cable_type']['#after_build'][] = '_foo_after_build';
}
}
/**
* After-build handler to add the example images to the inline/block element.
*/
function _foo_after_build($element, $form_state) {
foreach(element_children($element['value']) as $key) {
// Get the image-tag using a custom helper function.
$desc = _foo_get_img($key);
$element['value'][$key]['description'] = $desc;
}
return $element;
}This can be used on normal FAPI elements, and on CCK radio-buttons, as shown by the form-alter above.
Comments
appliance repai... (not verified)
May 4, 2011 - 1:33pm
Permalink
I’ve not too long ago started a blog, the knowledge you present on this website has helped me tremendously. Thanks for all your time & work.
Add new comment