Difference between revisions of "Projects/Usability/HIG/Notifications"

< Projects‎ | Usability‎ | HIG
Jump to: navigation, search
(Created page with "__NOTOC__ back to Human Interface Guidelines == Purpose == A ''notification'' is an information that is not relevant to actual workflow. It is displ...")
 
(8 intermediate revisions by 4 users not shown)
Line 1: Line 1:
 +
{{Construction}}
 
__NOTOC__
 
__NOTOC__
back to [[Projects/Usability/HIG|Human Interface Guidelines]]
+
 
 
== Purpose ==
 
== Purpose ==
A ''notification'' is an information that is not relevant to actual workflow. It is displayed via a certain [[Projects/Usability/HIG/NotificationMechanism|notification mechanism]] on a panel beneath the taskbar notification area. Notifications inform users about non-critical problems, but they don't prevent them.
+
A ''notification'' is an information that is not directly relevant to the user's current task. It is displayed via a certain [[Projects/Usability/HIG/NotificationMechanism|notification mechanism]] on a panel above/below the taskbar notification area. Notifications inform users about non-critical problems, but they don't prevent them.
  
Notifications pop-up and overlay all other windows. More than one notification are stacked vertically. Notifications disappear after a short period automatically, but can be closed by the user or keep visible by mouse over (remark: better description necessary). Each notification has its own [[Projects/Usability/HIG/CentralConfiguration|central configuration]] which can be reach by a small button with a wrench icon. (remark: icon description is too specific here)
+
Notifications pop up and overlay all other windows. Multiple notifications are stacked vertically. Notifications disappear after a short period automatically (unless the cursor hovers over them), but can be closed by the user at any point. Each notification has its own [[Projects/Usability/HIG/CentralConfiguration|central configuration]] which can be reached by a button next to the close button.
 
== Examples ==
 
== Examples ==
 
(remark: pictures only?)
 
(remark: pictures only?)
Line 13: Line 14:
 
* Low battery power
 
* Low battery power
 
todo: picture
 
todo: picture
=== (Epic) Fails ===
+
=== Negative ===
 
* Low space on medium (this information becomes relevant for file managers and invoked as modal message in this case)
 
* Low space on medium (this information becomes relevant for file managers and invoked as modal message in this case)
 
todo: picture
 
todo: picture
Line 19: Line 20:
 
* Do not use notifications for user assistance (consider to use [[Projects/Usability/HIG/Tooltip|tool-tips]] or [[Projects/Usability/HIG/Balloon|balloons]] for short information, or refer to [[Projects/Usability/HIG/HelpSystem|help system]] for extended text.
 
* Do not use notifications for user assistance (consider to use [[Projects/Usability/HIG/Tooltip|tool-tips]] or [[Projects/Usability/HIG/Balloon|balloons]] for short information, or refer to [[Projects/Usability/HIG/HelpSystem|help system]] for extended text.
 
* Do not use notifications for context relevant information that might interfere with the actual workflow (consider to use a [[Projects/Usability/HIG/MessageDialog|message dialog]].
 
* Do not use notifications for context relevant information that might interfere with the actual workflow (consider to use a [[Projects/Usability/HIG/MessageDialog|message dialog]].
* Do not add controls to notification.
+
* Do not add controls to notification. <span style="color:blue">Thomas: I would remove this. Adding action buttons is allowed in the API and has reasonable use cases, other controls simply cannot be added technically)</span>
* Do not override system settings. (remark: more specific)
+
* Do not override system settings. (remark: more specific) <span style="color:blue">Thomas: Which settings do you mean here?</span>
* Provide header and content text (remark: not precise enough)
+
* Provide title and content text (remark: not precise enough) <span style="color:blue">Thomas: guidelines regarding the wording of title and content are indeed very important. Maybe celeste can help here.</span>
* Add origin and topic to the header. For instance: "Amarok: Now playing" or "Konsole: Event"
+
* Make sure to make the origin of the notification clear from the notification title. For instance: "Amarok: Now playing" or "Konsole: Event"
* Notification content must not exceed three lines.
+
* Keep the notification content concise (no more than about three simple sentences).
* Customize notification with the origin's icon. (remark: word "origin" needs to be replaced; "icon" might be replaced by technical term)
+
* Customize notification with the origin's icon. <span style="color:blue">Heiko: (remark: word "origin" needs to be replaced; "icon" might be replaced by technical term) </span>
* Provide actionable information (e.g. "Low battery power" "Only 13 min (2%) capacity remaining. Please save your stuff now. Your system will get shut down soon.") (remark: should be according actual text)
+
* Provide actionable information (e.g. "Low battery power" "Only 13 min (2%) capacity remaining. Please save your stuff now. Your system will get shut down soon.") <span style="color:blue">Heiko: (remark: should be according actual text)</span>
to be defined: Are all notifications configured in KCM? If not, how to separate?
+
* <span style="color:blue">Heiko: to be defined: Are all notifications configured in KCM? If not, how to separate? -- Kai Uwe: All notifications emitted through KNotify (ie. application has a notifyrc file) can be configured. Using the FDO notification dbus iface directly is discouraged. In 4.11 there's a configure button on notifications.</span>
 +
 
 
== Code snippets ==
 
== Code snippets ==
 
to be done
 
to be done

Revision as of 11:12, 27 June 2013

Under construction.png
 
Under Construction
This is a new page, currently under construction!


Purpose

A notification is an information that is not directly relevant to the user's current task. It is displayed via a certain notification mechanism on a panel above/below the taskbar notification area. Notifications inform users about non-critical problems, but they don't prevent them.

Notifications pop up and overlay all other windows. Multiple notifications are stacked vertically. Notifications disappear after a short period automatically (unless the cursor hovers over them), but can be closed by the user at any point. Each notification has its own central configuration which can be reached by a button next to the close button.

Examples

(remark: pictures only?)

Positive

  • Email received
  • New update available
  • Download completed
  • Low battery power

todo: picture

Negative

  • Low space on medium (this information becomes relevant for file managers and invoked as modal message in this case)

todo: picture

Guidelines

  • Do not use notifications for user assistance (consider to use tool-tips or balloons for short information, or refer to help system for extended text.
  • Do not use notifications for context relevant information that might interfere with the actual workflow (consider to use a message dialog.
  • Do not add controls to notification. Thomas: I would remove this. Adding action buttons is allowed in the API and has reasonable use cases, other controls simply cannot be added technically)
  • Do not override system settings. (remark: more specific) Thomas: Which settings do you mean here?
  • Provide title and content text (remark: not precise enough) Thomas: guidelines regarding the wording of title and content are indeed very important. Maybe celeste can help here.
  • Make sure to make the origin of the notification clear from the notification title. For instance: "Amarok: Now playing" or "Konsole: Event"
  • Keep the notification content concise (no more than about three simple sentences).
  • Customize notification with the origin's icon. Heiko: (remark: word "origin" needs to be replaced; "icon" might be replaced by technical term)
  • Provide actionable information (e.g. "Low battery power" "Only 13 min (2%) capacity remaining. Please save your stuff now. Your system will get shut down soon.") Heiko: (remark: should be according actual text)
  • Heiko: to be defined: Are all notifications configured in KCM? If not, how to separate? -- Kai Uwe: All notifications emitted through KNotify (ie. application has a notifyrc file) can be configured. Using the FDO notification dbus iface directly is discouraged. In 4.11 there's a configure button on notifications.

Code snippets

to be done


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