From 7273a0eacc235c5b28394c064cdfc3fa72f0ef5a Mon Sep 17 00:00:00 2001 From: Paul Wicking Date: Thu, 5 Jan 2023 10:44:44 +0100 Subject: Doc: rewrite shortcut focus section As pointed out in review, somewhat contradictory advise. Rewrite the section to be more active, focus on the user and their application, and a bit more consistent. Pick-to: 6.5 Change-Id: Idbbf29d3033d32ade553290a2e89bd778876224c Reviewed-by: Volker Hilsheimer --- src/widgets/doc/src/widgets-and-layouts/focus.qdoc | 13 +++++++++---- 1 file changed, 9 insertions(+), 4 deletions(-) (limited to 'src/widgets/doc/src/widgets-and-layouts') diff --git a/src/widgets/doc/src/widgets-and-layouts/focus.qdoc b/src/widgets/doc/src/widgets-and-layouts/focus.qdoc index 6b4d119663..6cd8e58543 100644 --- a/src/widgets/doc/src/widgets-and-layouts/focus.qdoc +++ b/src/widgets/doc/src/widgets-and-layouts/focus.qdoc @@ -126,12 +126,17 @@ explicitly using focus accelerators such as those provided by QLabel::setBuddy(), QGroupBox, and QTabBar. - We advise supporting shortcut focus for all widgets that the user + Your application can support shortcut focus for all widgets that the user may want to jump to. For example, a tab dialog can have keyboard shortcuts for each of its pages, so the user can press e.g. \uicontrol - Alt+P to step to the \underline{P}rinting page. It is easy to - overdo this: there are only a few keys, and it's also important - to provide keyboard shortcuts for commands. + Alt+P to step to the \underline{P}rinting page. Keep in mind that it's easy + to overdo this, as there are only a few keys, and also important to provide + keyboard shortcuts for commands. Refer to the design guidelines for the + platform you target, for example Microsoft's \l + {https://learn.microsoft.com/en-us/previous-versions/windows/desktop/dnacc/guidelines-for-keyboard-user-interface-design} + {guidelines for keyboard user interface design} or Apple's \l + {https://developer.apple.com/design/human-interface-guidelines/inputs/focus-and-selection/} + {focus and selection} guidelines. \section2 The User Rotates the Mouse Wheel -- cgit v1.2.3