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

Jump to: navigation, search
(Move notice)
 
(19 intermediate revisions by 4 users not shown)
Line 1: Line 1:
==Definition==
+
__NOTOC__
  
A toggle button is a button which stays down when clicked once and goes up when clicked a second time.
+
{{Note|This page is now on [[https://hig.kde.org/components/editing/togglebutton.html https://hig.kde.org/]]}}
 
+
==When to use==
+
 
+
Use a toggle button to indicate a '''state'''.
+
 
+
Example: A word processor should use toggle buttons to indicate the state of "Bold", "Italic" or "Underline" formatting.
+
 
+
==When not to use==
+
 
+
Do not use a toggle button to indicate an '''action'''.
+
 
+
Example: A music player should not use a toggle button to implement a Play/Pause button. It should use a normal button and adjust the icon and label to represent the action which would be performed when clicked.
+
 
+
==How to Use==
+
 
+
===Label Wording===
+
 
+
Label of toggle buttons can often be reduced to a "noun only" form instead of the classic "verb (+ noun)" used with classic buttons. The "noun only" form should be favored over the "verb (+ noun)" form whenever it does not cause any ambiguity as this form reduces clutter.
+
 
+
Example: A toggle button to show/hide a sidebar can be labeled either "Show Sidebar" or simply "Sidebar".
+
 
+
===Changing Icon and/or Label===
+
 
+
Never change the icon or label of a toggle button. A toggle button is very similar to a check box and should thus behave in the same way. The fact that it is pressed down is enough to indicate the current state of the element it represents.
+
 
+
This means that in the previous example, "Show Sidebar" should not be turned into "Hide Sidebar" when the sidebar is visible. If you consider it more explicit to change the icon and label of your button then you should use a normal button, not a toggle button.
+
 
+
[[File:Toggle-button-summary.png]]
+

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 modified on 5 February 2019, at 19:46. Content is available under Creative Commons License SA 4.0 unless otherwise noted.