Keyboard shortcut support

[eppfel]

A few apps have awesome keyboard shortcuts, which makes it super easy and fast to use nextcloud. I think we should define standards for nextcloud, so the shortcuts are consistent.

Additionally It would be nice to have a current shortcut overview help like github does it.
(Try it by pushing the ? key)
Could this work as an app?

---

Keyboard shortcuts proposal

Advised general shortcuts

Shortcut	Action
r	Reload messages / feed
▶︎ / j / n	Next item / file
◀︎ / k / p	Previous message / item / file
del	Delete message
o / enter	open Item
q	Focus internal search
u	Toggle read/unread
s	Toggle Star (flag) message
c	create item
esc	close menu

Items can be mails, files, folders, etc., if not stated otherwise

Shortcuts/combinations that should be avoided

• Combinations with ctrl and cmd in general
• ▼ and ▲, because of interference with scrolling

Undecided shortcuts from News App

Maybe to special to generalize them

Shortcut	Action
e	expandItem
i / l	toggleStar
h	toggleStar && scrollToNextItem
f	nextFeed
d	previousFeed
c	previousFolder
a	scrollToActiveNavigationEntry
v	nextFolder
shift + a	markAllRead

Keybaord shortcuts: actual state

Files App

Shortcut	Action
ctrl/cmd + n	new folder
ctrl/cmd + shift + n	new file
esc	close menu (while new file context menu is open)
up/down	select file/folder
enter	open file/folder
delete/backspace	delete file/folder
ctrl/cmd + f	focus search field
esc	close menu

Mail App

Shortcut	Action
r	Reload messages
◀︎	Previous message
▶︎	Next message
s	Star (flag) message
u	Toggle read/unread
del	Delete message

News App

Shortcut	Action
j / n / ▶︎	scrollToNextItem
k / p / ◀︎	scrollToPreviousItem
u	toggleUnread
e	expandItem
s / i / l	toggleStar
h	toggleStar && scrollToNextItem
o	openLink
r	reloadFeed
f	nextFeed
d	previousFeed
c	previousFolder
a	scrollToActiveNavigationEntry
v	nextFolder
q	Focus search
shift + a	markAllRead

Todo:

• collect the shortcuts that are already available
• general: improve tabindex
• general: shortcuts for navigation / menu
  • jump to apps menu
  • jump to sidebar
  • jump to settings menu
  • select menu point (sidebar/apps/settings) with arrow keys
• add a dedicated page in the documentation
• files app: add file option (maybe distinct issue)
  • rename
  • open and focus details
  • share (is an essential feature and should be able to be directly executed on a selected file)
  • descend into newly created folder by clicking enter again [New folder creation flow: descend into newly created folder by clicking enter again #1905]
• contacts app
• calendar app [Keyboard support calendar#157]
• gallery app
• ?app for a helper listing shortcuts in the current view

[MariusBluem]

...to make something great again also reminds me on this nice guy with the fancy haircut 😜

[eppfel]

@ChristophWurst Could you post/link the mail shortcuts?

[ChristophWurst]

Shortcut	Action
r	Reload messages
◀︎	Previous message
▶︎	Next message
s	Star (flag) message
u	Toggle read/unread
del	Delete message

[eppfel]

So, I just started implementing a proof-of-concept app for this "keyboard shortcut helper". Github uses facebox, which was not maintained for years. Are there modals in nextcloud? The only one I can think of, is in the first run wizard.

And what other apps besides mail use shortcuts, yet? I am not aware of any other. Maybe we postpone this, until our Design Guide is ready.

[MorrisJobke]

Are there modals in nextcloud? The only one I can think of, is in the first run wizard.

There are, but they build on an old version of jQuery UI and we try to get rid of this. Beside that these are dialog based modals (with buttons to accept or decline the stuff).