Difference between revisions of "Projects/Usability/HIG/Form Label Alignment"

< Projects‎ | Usability‎ | HIG
Jump to: navigation, search
(new content)
 
(Refreshed checkbox section)
(7 intermediate revisions by 4 users not shown)
Line 1: Line 1:
One of the new changes in KDE 4.x since KDE 3.x is the alignment of form and widget labels.  In KDE 3.x, labels were aligned to the left and widgets were aligned to the left.  In KDE 4, form labels are now aligned to the right and widgets are aligned to the left, making a group of form widgets appear to be center aligned.
+
== Label Alignment ==
  
[[Image:Wiki-alignment-1.png|frame|Example of KDE 3 form alignment]]
+
One of the new changes in KDE 4.x since KDE 3.x is the alignment of form and widget labels.  In KDE 3.x, labels were aligned to the left and widgets were aligned to the left.  In KDE 4, form labels are now aligned to the right and widgets are aligned to the left, making a group of form widgets appear to be center aligned.  In Qt4, using a [http://doc.trolltech.com/qformlayout.html QFormLayout] handles this correctly for you.
  
[[Image:Wiki-alignment-3.png|frame|Example of KDE4 form alignment]]
+
{|
 +
|[[Image:Wiki-alignment-1.png|frame|Example of KDE3 form alignment]]
 +
|[[Image:Wiki-alignment-3.png|frame|Example of KDE4 form alignment]]
 +
|}
  
 
== Dialog Alignment ==
 
== Dialog Alignment ==
Line 9: Line 12:
 
In OSX, a group of widgets is center aligned.  In KDE4, a group of widgets is left aligned.  This aligns the labels closer to the left edge and makes use of space more efficiently.   
 
In OSX, a group of widgets is center aligned.  In KDE4, a group of widgets is left aligned.  This aligns the labels closer to the left edge and makes use of space more efficiently.   
  
[[Image:Wiki-alignment-2.png|frame|Example of OSX form alignment]]
+
{|
 
+
|[[Image:Wiki-alignment-2.png|frame|Example of OSX form alignment]]
[[Image:Wiki-alignment-3.png|frame|Example of KDE4 form alignment]]
+
|[[Image:Wiki-alignment-3.png|frame|Example of KDE4 form alignment]]
 +
|}
  
 
The alignment of groups of widgets is independent, and so you may have different sized groups with different "centered" lines.  A group of widgets consists of widgets within some type of natural separation such as a group box or separator bar.
 
The alignment of groups of widgets is independent, and so you may have different sized groups with different "centered" lines.  A group of widgets consists of widgets within some type of natural separation such as a group box or separator bar.
  
[[Image:Wiki-alignment-4.png|frame|Example of multiple group alignment in KDE4]]
+
[[Image:Wiki-alignment-4.png|frame|center|Example of multiple group alignment in KDE4]]
  
 
== Checkboxes ==
 
== Checkboxes ==
  
=== Problems with QT 4 ===
+
The text of a checkbox is on the right of its tick rectangle, which can make it difficult to avoid blank areas on the left side of the form. To keep the layout of the form balanced you can use one of the following approaches:
 +
 
 +
1. Group checkboxes together in the widget column and add a label describing the group in the label column:
 +
 
 +
[[Image:Hig-grouped-checkboxes.png|frame|center|Grouped checkboxes]]
 +
 
 +
2. Make the checkboxes span the two columns, but keep them at the bottom of the form:
 +
 
 +
[[Image:Hig-two-column-checkboxes.png|frame|center|Checkboxes spanning two columns]]
 +
 
 +
3. If all else fails, add a label describing the checkbox on the left side of the checkbox, then set the text of the checkbox to "Enabled", "On", or similar.
 +
 
 +
[[Image:Hig-checkbox-separate-label.png|frame|center|Using a separate title label for the checkbox.]]
 +
 
 +
== Aligning Sub-Options ==
 +
 
 +
When options are subordinate to a checkbox or radiobutton (e.g. Audio level can only be set if the Activate Audio option is selected), this relation should be visualized by indenting the sub-options. There are two options to do so:
 +
 
 +
1. When you are using a left-aligned checkbox or radio button, indent the sub-options by using a horizontal spacer of SizeType "Minimum".
 +
 
 +
[[Image:Wiki-alignment-7.png|frame|center|Example of aligning sub-options with a horizontal spacer of SizeType "Minimum".]]
 +
 
 +
2. When you are using a checkbox that is placed right to its label, indent the sub-options in the same vertical axis as the checkbox.
 +
 
 +
[[Image:Wiki-alignment-5.png|frame|center|Example of aligning sub-options with the same vertical axis as the checkbox itself.]]
 +
 
 +
'''The contents of this guideline are under discussion.  Please request guidance in #kde-usability if you have any questions regardling Form Label Alignment'''
 +
 
 +
== Grouping related options within a GroupBox ==
 +
 
 +
In some cases it may be useful to visually separate groups of related options within one GroupBox to facilitate scanning of the dialog.
 +
 
 +
In that case, put a vertical fixed size spacer of 16px height between the options.
  
The checkbox widget in QT 4 is the input click box on the left and the label on the right. Unfortunately, it difficult to create a checkbox with a label on the right of the input click box.  This is a problem because there are common cases when the label on the left of the input click box is better usability.  Until there is a resolution that makes configuring the checkbox label to the left of the input click box easier, use the default checkbox alignment (right aligned label).
+
[[Image:Wiki-alignment-6.png|frame|center|Example of separating groups of related options with a vertical spacer.]]
  
 
== Examples ==
 
== Examples ==

Revision as of 13:47, 31 May 2013

Contents

Label Alignment

One of the new changes in KDE 4.x since KDE 3.x is the alignment of form and widget labels. In KDE 3.x, labels were aligned to the left and widgets were aligned to the left. In KDE 4, form labels are now aligned to the right and widgets are aligned to the left, making a group of form widgets appear to be center aligned. In Qt4, using a QFormLayout handles this correctly for you.

Example of KDE3 form alignment
Example of KDE4 form alignment

Dialog Alignment

In OSX, a group of widgets is center aligned. In KDE4, a group of widgets is left aligned. This aligns the labels closer to the left edge and makes use of space more efficiently.

Example of OSX form alignment
Example of KDE4 form alignment

The alignment of groups of widgets is independent, and so you may have different sized groups with different "centered" lines. A group of widgets consists of widgets within some type of natural separation such as a group box or separator bar.

Example of multiple group alignment in KDE4

Checkboxes

The text of a checkbox is on the right of its tick rectangle, which can make it difficult to avoid blank areas on the left side of the form. To keep the layout of the form balanced you can use one of the following approaches:

1. Group checkboxes together in the widget column and add a label describing the group in the label column:

Grouped checkboxes

2. Make the checkboxes span the two columns, but keep them at the bottom of the form:

Checkboxes spanning two columns

3. If all else fails, add a label describing the checkbox on the left side of the checkbox, then set the text of the checkbox to "Enabled", "On", or similar.

Using a separate title label for the checkbox.

Aligning Sub-Options

When options are subordinate to a checkbox or radiobutton (e.g. Audio level can only be set if the Activate Audio option is selected), this relation should be visualized by indenting the sub-options. There are two options to do so:

1. When you are using a left-aligned checkbox or radio button, indent the sub-options by using a horizontal spacer of SizeType "Minimum".

Example of aligning sub-options with a horizontal spacer of SizeType "Minimum".

2. When you are using a checkbox that is placed right to its label, indent the sub-options in the same vertical axis as the checkbox.

Example of aligning sub-options with the same vertical axis as the checkbox itself.

The contents of this guideline are under discussion. Please request guidance in #kde-usability if you have any questions regardling Form Label Alignment

Grouping related options within a GroupBox

In some cases it may be useful to visually separate groups of related options within one GroupBox to facilitate scanning of the dialog.

In that case, put a vertical fixed size spacer of 16px height between the options.

Example of separating groups of related options with a vertical spacer.

Examples

[Screenshots of example dialog layouts simple and complex]

More Information

Label Placement in Forms


KDE® and the K Desktop Environment® logo are registered trademarks of KDE e.V.Legal