Difference between revisions of "KDE Visual Design Group/HIG/Toggle Buttons"

Jump to: navigation, search
m (Is this the right control)
(Move notice)
 
(One intermediate revision by one other user not shown)
Line 1: Line 1:
 
__NOTOC__
 
__NOTOC__
  
== Purpose ==
+
{{Note|This page is now on [[https://hig.kde.org/components/editing/togglebutton.html https://hig.kde.org/]]}}
''Toggle buttons'' look similar to regular buttons, but are used to show or change a state rather than initiate an action. A toggle button's two states, set and unset, are shown by its appearing "pushed in" or "popped out" respectively.
 
 
 
Toggle buttons are a valid option to indicate a state with the advance of using an icon. Compared to the related radio button or check box they are an efficient way to save screen space. But toggle buttons should be used with care outside a toolbar because the state is not clearly indicated.
 
 
 
== Example ==
 
 
 
== Guidelines ==
 
=== Is this the right control ===
 
* Use a toggle button to indicate a state if no other control apply, i.e. in case of the [[../Toolbar|toolbar]].
 
* Prefer [[KDE_Visual_Design_Group/HIG/Radio_Buttons|radio buttons]] or [[KDE_Visual_Design_Group/HIG/Check_Box|check boxes]] outside the toolbar.
 
 
 
=== Behavior ===
 
* Group toggle buttons in case of multiple selection.
 
* Separate toggle buttons from other controls, so they are not mistaken for push buttons.
 
* Do not use a toggle button to initiate an action.
 
* Do not change the label according the button state.
 
=== Appearance ===
 
* Align groups of toggle buttons horizontally rather than vertically.
 
* Provide an access key in the label of all toggle buttons that allows the user to set or unset the button directly from the keyboard.
 
== Implementation ==
 
[http://api.kde.org/4.10-api/kdelibs-apidocs/kdeui/html/classKPushButton.html#KPushButton] for generic buttons.
 
[http://api.kde.org/4.10-api/kdelibs-apidocs/kdeui/html/classKAction.html#KAction] is used to generate buttons in toolbars.
 

Latest revision as of 19:46, 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 19:46. Content is available under Creative Commons License SA 4.0 unless otherwise noted.