Difference between revisions of "KDE Visual Design Group/HIG/RadioButtons"

Jump to: navigation, search
(Guidelines)
(Move notice)
 
(17 intermediate revisions by 5 users not shown)
Line 1: Line 1:
 
__NOTOC__
 
__NOTOC__
  
== Purpose ==
+
{{Note|This page is now on [[https://hig.kde.org/components/editing/radiobutton.html https://hig.kde.org/]]}}
''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 ==
 
[[File:Radio_buttons.png]]
 
 
 
== 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 [[KDE_Visual_Design_Group/HIG/Combo_Box| 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 [[KDE_Visual_Design_Group/HIG/Check_Box| 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 [[../Buttons|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.
 
 
 
=== Appearance ===
 
* Provide a descriptive label above or left to a group of radio buttons in [[KDE_Visual_Design_Group/HIG/Capitalization#Sentence_Style_Capitalization|sentence style capitalization]].
 
* Use [[KDE_Visual_Design_Group/HIG/Capitalization#Title_Capitalization|title style capitalization]] for the radio button options.
 
* Align groups of radio buttons vertically rather than horizontally, as this makes them easier to scan visually.
 
* 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.
 
* 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.
 
 
 
== Implementation ==
 
* [http://qt-project.org/doc/qt-4.8/qradiobutton.html QRadioButton]
 
* [http://qt-project.org/doc/qt-4.8/qbuttongroup.html QButtonGroup]
 

Latest revision as of 16:15, 5 February 2019


Note-box-icon.png
Note
This page is now on [https://hig.kde.org/]

This page was last edited on 5 February 2019, at 16:15. Content is available under Creative Commons License SA 4.0 unless otherwise noted.