Projects/Usability/HIG/RadioButtons: Difference between revisions

    From KDE TechBase
    < Projects‎ | Usability‎ | HIG
    No edit summary
    m ([http://qt-project.org/doc/qt-4.8/qradiobutton.html QRadioButton] → {{qt|QRadioButton}})
    (25 intermediate revisions by 3 users not shown)
    Line 8: Line 8:


    == Guidelines ==
    == Guidelines ==
    * Use radio buttons for a few mutually exclusive options. If there are more than five options, use a combo box or list instead. In case of artificial opposite options (apply vs. don't apply) consider to replace the radio buttons by one checkbox.
    === Is this the right control ===
    * Use radio buttons for a few mutually exclusive options. If there are more than five options (or if there is not enough space to arrange four or five options), use a combo box or list instead.
    *: [[File:RadioButtons-1-bad.png]]  [[File:RadioButtons-1-good.png]]
    * If there are only two options where one is the negation of the other (e.g. "apply" vs. "do not apply"), consider replacing the radio buttons by one [[Projects/Usability/HIG/Check_Box| check box]].
    *: [[File:RadioButtons-2-bad.png]]  [[File:RadioButtons-2-good.png]]
    * Use radio buttons if the user should see the choices without further interaction.
    * Use radio buttons if the user should see the choices without further interaction.
    * Provide a descriptive label above or left to a group of radio buttons in [[Projects/Usability/HIG/Capitalization|sentence style capitalization]].
    *: [[File:RadioButtons-3-bad.png]] [[File:RadioButtons-3-good.png]]
    * Use [[Projects/Usability/HIG/Capitalization|title style capitalization]] the radio button options.
    * Do not use a radio button to initiate an action. Consider using a [[../Buttons|push button]] instead.
    * Align groups of radio buttons vertically rather than horizontally, as this makes them easier to scan visually. Use horizontal or rectangular alignments only if they greatly improve the layout of the window.
     
    === Behavior ===
    * Radio buttons are not dynamic; their content or labels should not change depending on the context.
    * Radio buttons are not dynamic; their content or labels should not change depending on the context.
    * If toggling a radio button affects the enabled state of other controls, place the controls that it affects next to the radio button or below and indented.
    * Always have one radio button selected.
    * Don't initiate an action when the user clicks a radio button.
    *: [[File:RadioButtons-6-bad.png]]  [[File:RadioButtons-6-good.png]]
    * Make the first item the default option.
    *: [[File:RadioButtons-7-bad.png]]  [[File:RadioButtons-7-good.png]]
    * When using a radio button and none of the options is a valid choice, add another option to reflect this choice, such as None or Does not apply.
    * When using a radio button and none of the options is a valid choice, add another option to reflect this choice, such as None or Does not apply.
    * Always have one radio button selected; make the first item the default option.


    == Code snippets ==
    === Appearance ===
    to be done
    * When options are subordinate to a radio box, this relation should be visualized by indenting the sub-options by using a horizontal spacer of SizeType "Minimum".
     
    * If activating a choice affects the appearance or the enabled state of other controls, place them next to the radio button (group).
    * Align radio buttons vertically rather than horizontally, as this makes them easier to scan visually. Use horizontal or rectangular alignments only if they greatly improve the layout of the window.
    * If certain controls in a configuration dialog are only relevant if a certain radio button is toggled on (i.e. they are dependent controls), disable them instead of hiding them if that radio button is toggled off.
     
    * Do not separate radio button and label. Clicking on both the button and the label should toggle the option.
    * Do not add line breaks. If necessary place an additional label below the check box.
    * Label a group of radio buttons with a descriptive caption to the top left of the group (cf. [[Projects/Usability/HIG/Alignment| alignment]]).
    * Create a buddy relation so access keys are assigned.
    * Use [[Projects/Usability/HIG/Capitalization|sentence style capitalization]] for radio buttons.
    * Do not use ending punctuation (neither dot nor colon) for group label.
     
    == Implementation ==
    * {{qt|QRadioButton}}
    * {{qt|QButtonGroup}}
     
    [[Category:Usability]][[Category:Behavior]][[Category:Editing_and_Manipulation]][[Category:Selection]]

    Revision as of 21:05, 3 August 2013


    Purpose

    Radio buttons offer the user a choice of two or more mutually exclusive options. Try to limit the number of radio buttons and radio button groups in a dialog. Offering a high number of radio buttons consumes screen space and adds to visual clutter. At the same time, showing all available options at once is an advantage if users are likely not to know possible alternatives.

    Examples

    Guidelines

    Is this the right control

    • Use radio buttons for a few mutually exclusive options. If there are more than five options (or if there is not enough space to arrange four or five options), use a combo box or list instead.
    • If there are only two options where one is the negation of the other (e.g. "apply" vs. "do not apply"), consider replacing the radio buttons by one check box.
    • Use radio buttons if the user should see the choices without further interaction.
    • Do not use a radio button to initiate an action. Consider using a push button instead.

    Behavior

    • Radio buttons are not dynamic; their content or labels should not change depending on the context.
    • Always have one radio button selected.
    • Make the first item the default option.
    • When using a radio button and none of the options is a valid choice, add another option to reflect this choice, such as None or Does not apply.

    Appearance

    • When options are subordinate to a radio box, this relation should be visualized by indenting the sub-options by using a horizontal spacer of SizeType "Minimum".
    • If activating a choice affects the appearance or the enabled state of other controls, place them next to the radio button (group).
    • Align radio buttons vertically rather than horizontally, as this makes them easier to scan visually. Use horizontal or rectangular alignments only if they greatly improve the layout of the window.
    • If certain controls in a configuration dialog are only relevant if a certain radio button is toggled on (i.e. they are dependent controls), disable them instead of hiding them if that radio button is toggled off.
    • Do not separate radio button and label. Clicking on both the button and the label should toggle the option.
    • Do not add line breaks. If necessary place an additional label below the check box.
    • Label a group of radio buttons with a descriptive caption to the top left of the group (cf. alignment).
    • Create a buddy relation so access keys are assigned.
    • Use sentence style capitalization for radio buttons.
    • Do not use ending punctuation (neither dot nor colon) for group label.

    Implementation