Radio Button element

Introduction​

Details Tab​

Options​

• Sub Options - The list of Options for the radio buttons. Use the green + to add more, the red - to remove Options and the grey boxes on the right to drag and drop to change the order.
  NOTE: Options can be programmatically added to this list Using eval Populate on the Advanced tab.
  • Value - The value that is stored in the database if the drop down option is selected.
  • Label - The label that appears next to the drop down option. Equally this label is shown in the table view rather than the recorded value (which is stored in the database table itself)
  • Default - is the option selected as default
• Options per row - Specify the number of columns used to render the radio buttons. A smaller number will place the Options FARTHER apart. If you have short Options, then choosing a number like 8 would help move the Options closer together without as much whitespace between them.
• Button group - Renders the Options as a Bootstrap 'button group' vs. the traditional html radio buttons (a button group is similar to the No/Yes choice of button group).
  BUTTON GROUP NOTES:
  • Button Groups work only on Joomla 3 (with Bootstrap)
    
  • If you use Javascript events, you have to use a click event (and not the change event).

Front End Addition​

• Allow user to add drop down option - Allow your form's users to add in additional Options to your form.
• Only add label - If no selected then the user has to enter both a value and a label for the checkbox option they are adding. If yes selected then only a label field is presented to the user the value of which is then used for the value and label.
• Save new additions - If yes selected then the newly submitted option is stored by the element, meaning subsequent users of the form will be able to select the same value.

Advanced Options​

• Eval Populate - PHP that can generate a list of Options to add to list added using JHTML.
  See also the dropdown element
  
• For example, here is some code that will build a list of years from the current year and the previous 10 years.
  
  PHP:

  for ($year = date('Y'); $year > date('Y', strtotime('-10 years')); $year--) {
  
    $options[] = JHTML::_('select.option',$year,$year); }
  
  return $options;

• Note: There is no way to specify a default selected option using this method.

Additional data​

• Data was entered manually into the database
• Data previously entered from a radio sub option that has been subsequently deleted
• The user has been allowed (possibly at some point) to add their own options but not set to store that added option as a option available to other users.