Overview
The radio field creates a simple list of radio inputs where you are able to select a single choice from the predefined list.
Screenshots
Inline:
Multiline:
Settings
Besides the common settings, this field has the following specific settings:
Name | Description |
---|---|
options |
Array of 'value' => 'Label' pairs. They’re used to display choices to users. value is stored in the custom field. Required. |
inline |
Whether to show all choices in the same line (true - default) or multiline (false ). |
Note that the multiple
setting is always set to false
for this field.
Sample code
array(
'name' => 'Radio',
'id' => 'radio',
'type' => 'radio',
// Array of 'value' => 'Label' pairs for radio options.
// Note: the 'value' is stored in meta field, not the 'Label'
'options' => array(
'value1' => 'Label1',
'value2' => 'Label2',
),
// Show choices in the same line?
'inline' => false,
),
Data
This field simply saves a single selected value in the database.
If the field is cloneable, then the value is stored as a serialized array in a single row in the database.
Template usage
To get the field value, use this code:
$value = rwmb_meta( $field_id );
echo $value;
The rwmb_meta() function returns the value saved in the database (the value
in the options
array). If you want to display the label, use this code:
rwmb_the_value( $field_id );
Read more about rwmb_meta() and rwmb_the_value().