import * as React from 'react'; import classNames from 'classnames'; import { useRestoreFocus } from './hooks'; import { LocalizerType } from '../types/Util'; export type Props = { hasInstalledStickers: boolean; platform: string; readonly close: () => unknown; readonly i18n: LocalizerType; }; type KeyType = | 'commandOrCtrl' | 'optionOrAlt' | 'shift' | 'enter' | '↑' | '↓' | ',' | '.' | 'A' | 'C' | 'D' | 'F' | 'J' | 'L' | 'M' | 'P' | 'R' | 'S' | 'T' | 'U' | 'V' | 'X'; type ShortcutType = { description: string; keys: Array; }; const NAVIGATION_SHORTCUTS: Array = [ { description: 'Keyboard--navigate-by-section', keys: ['commandOrCtrl', 'T'], }, { description: 'Keyboard--previous-conversation', keys: ['optionOrAlt', '↑'], }, { description: 'Keyboard--next-conversation', keys: ['optionOrAlt', '↓'], }, { description: 'Keyboard--previous-unread-conversation', keys: ['optionOrAlt', 'shift', '↑'], }, { description: 'Keyboard--next-unread-conversation', keys: ['optionOrAlt', 'shift', '↓'], }, { description: 'Keyboard--preferences', keys: ['commandOrCtrl', ','], }, { description: 'Keyboard--open-conversation-menu', keys: ['commandOrCtrl', 'shift', 'L'], }, { description: 'Keyboard--search', keys: ['commandOrCtrl', 'F'], }, { description: 'Keyboard--search-in-conversation', keys: ['commandOrCtrl', 'shift', 'F'], }, { description: 'Keyboard--focus-composer', keys: ['commandOrCtrl', 'shift', 'T'], }, { description: 'Keyboard--open-all-media-view', keys: ['commandOrCtrl', 'shift', 'M'], }, { description: 'Keyboard--open-emoji-chooser', keys: ['commandOrCtrl', 'shift', 'J'], }, { description: 'Keyboard--open-sticker-chooser', keys: ['commandOrCtrl', 'shift', 'S'], }, { description: 'Keyboard--begin-recording-voice-note', keys: ['commandOrCtrl', 'shift', 'V'], }, { description: 'Keyboard--archive-conversation', keys: ['commandOrCtrl', 'shift', 'A'], }, { description: 'Keyboard--unarchive-conversation', keys: ['commandOrCtrl', 'shift', 'U'], }, { description: 'Keyboard--scroll-to-top', keys: ['commandOrCtrl', '↑'], }, { description: 'Keyboard--scroll-to-bottom', keys: ['commandOrCtrl', '↓'], }, { description: 'Keyboard--close-curent-conversation', keys: ['commandOrCtrl', 'shift', 'C'], }, ]; const MESSAGE_SHORTCUTS: Array = [ { description: 'Keyboard--default-message-action', keys: ['enter'], }, { description: 'Keyboard--view-details-for-selected-message', keys: ['commandOrCtrl', 'D'], }, { description: 'Keyboard--toggle-reply', keys: ['commandOrCtrl', 'shift', 'R'], }, { description: 'Keyboard--save-attachment', keys: ['commandOrCtrl', 'S'], }, { description: 'Keyboard--delete-message', keys: ['commandOrCtrl', 'shift', 'D'], }, ]; const COMPOSER_SHORTCUTS: Array = [ { description: 'Keyboard--add-newline', keys: ['shift', 'enter'], }, { description: 'Keyboard--expand-composer', keys: ['commandOrCtrl', 'shift', 'X'], }, { description: 'Keyboard--send-in-expanded-composer', keys: ['commandOrCtrl', 'enter'], }, { description: 'Keyboard--attach-file', keys: ['commandOrCtrl', 'U'], }, { description: 'Keyboard--remove-draft-link-preview', keys: ['commandOrCtrl', 'P'], }, { description: 'Keyboard--remove-draft-attachments', keys: ['commandOrCtrl', 'shift', 'P'], }, ]; export const ShortcutGuide = (props: Props) => { const focusRef = React.useRef(null); const { i18n, close, hasInstalledStickers, platform } = props; const isMacOS = platform === 'darwin'; // Restore focus on teardown useRestoreFocus(focusRef); return (
{i18n('Keyboard--header')}
{i18n('Keyboard--navigation-header')}
{NAVIGATION_SHORTCUTS.map((shortcut, index) => { if ( !hasInstalledStickers && shortcut.description === 'Keyboard--open-sticker-chooser' ) { return null; } return renderShortcut(shortcut, index, isMacOS, i18n); })}
{i18n('Keyboard--messages-header')}
{MESSAGE_SHORTCUTS.map((shortcut, index) => renderShortcut(shortcut, index, isMacOS, i18n) )}
{i18n('Keyboard--composer-header')}
{COMPOSER_SHORTCUTS.map((shortcut, index) => renderShortcut(shortcut, index, isMacOS, i18n) )}
); }; function renderShortcut( shortcut: ShortcutType, index: number, isMacOS: boolean, i18n: LocalizerType ) { return (
{i18n(shortcut.description)}
{shortcut.keys.map((key, mapIndex) => { let label: string = key; let isSquare = true; if (key === 'commandOrCtrl' && isMacOS) { label = '⌘'; } if (key === 'commandOrCtrl' && !isMacOS) { label = i18n('Keyboard--Key--ctrl'); isSquare = false; } if (key === 'optionOrAlt' && isMacOS) { label = i18n('Keyboard--Key--option'); isSquare = false; } if (key === 'optionOrAlt' && !isMacOS) { label = i18n('Keyboard--Key--alt'); isSquare = false; } if (key === 'shift') { label = i18n('Keyboard--Key--shift'); isSquare = false; } if (key === 'enter') { label = i18n('Keyboard--Key--enter'); isSquare = false; } return ( {label} ); })}
); }