436 lines
10 KiB
JavaScript
436 lines
10 KiB
JavaScript
// @flow
|
|
import * as React from "react";
|
|
import { useTranslation } from "react-i18next";
|
|
import styled from "styled-components";
|
|
import Flex from "components/Flex";
|
|
import InputSearch from "components/InputSearch";
|
|
import Key from "components/Key";
|
|
import { metaDisplay } from "utils/keyboard";
|
|
|
|
function KeyboardShortcuts() {
|
|
const { t } = useTranslation();
|
|
|
|
const categories = React.useMemo(
|
|
() => [
|
|
{
|
|
title: t("Navigation"),
|
|
items: [
|
|
{
|
|
shortcut: <Key>n</Key>,
|
|
label: t("New document"),
|
|
},
|
|
{ shortcut: <Key>e</Key>, label: t("Edit current document") },
|
|
{ shortcut: <Key>m</Key>, label: t("Move current document") },
|
|
{
|
|
shortcut: (
|
|
<>
|
|
<Key>/</Key> or <Key>t</Key>
|
|
</>
|
|
),
|
|
label: t("Jump to search"),
|
|
},
|
|
{ shortcut: <Key>d</Key>, label: t("Jump to home") },
|
|
{
|
|
shortcut: (
|
|
<>
|
|
<Key>Ctrl</Key> + <Key>Alt</Key> + <Key>h</Key>
|
|
</>
|
|
),
|
|
label: t("Table of contents"),
|
|
},
|
|
{
|
|
shortcut: (
|
|
<>
|
|
<Key>{metaDisplay}</Key> + <Key>.</Key>
|
|
</>
|
|
),
|
|
label: t("Toggle navigation"),
|
|
},
|
|
{
|
|
shortcut: (
|
|
<>
|
|
<Key>{metaDisplay}</Key> + <Key>f</Key>
|
|
</>
|
|
),
|
|
label: t("Focus search input"),
|
|
},
|
|
{ shortcut: <Key>?</Key>, label: t("Open this guide") },
|
|
{
|
|
shortcut: (
|
|
<>
|
|
<Key>{metaDisplay}</Key> + <Key>Enter</Key>
|
|
</>
|
|
),
|
|
label: t("Save document and exit"),
|
|
},
|
|
{
|
|
shortcut: (
|
|
<>
|
|
<Key>{metaDisplay}</Key> + <Key>⇧</Key> + <Key>p</Key>
|
|
</>
|
|
),
|
|
label: t("Publish document and exit"),
|
|
},
|
|
{
|
|
shortcut: (
|
|
<>
|
|
<Key>{metaDisplay}</Key> + <Key>s</Key>
|
|
</>
|
|
),
|
|
label: t("Save document"),
|
|
},
|
|
{
|
|
shortcut: (
|
|
<>
|
|
<Key>{metaDisplay}</Key> + <Key>Esc</Key>
|
|
</>
|
|
),
|
|
label: t("Cancel editing"),
|
|
},
|
|
],
|
|
},
|
|
{
|
|
title: t("Formatting"),
|
|
items: [
|
|
{
|
|
shortcut: (
|
|
<>
|
|
<Key>Ctrl</Key> + <Key>⇧</Key> + <Key>0</Key>
|
|
</>
|
|
),
|
|
label: t("Paragraph"),
|
|
},
|
|
{
|
|
shortcut: (
|
|
<>
|
|
<Key>Ctrl</Key> + <Key>⇧</Key> + <Key>1</Key>
|
|
</>
|
|
),
|
|
label: t("Large header"),
|
|
},
|
|
{
|
|
shortcut: (
|
|
<>
|
|
<Key>Ctrl</Key> + <Key>⇧</Key> + <Key>2</Key>
|
|
</>
|
|
),
|
|
label: t("Medium header"),
|
|
},
|
|
{
|
|
shortcut: (
|
|
<>
|
|
<Key>Ctrl</Key> + <Key>⇧</Key> + <Key>3</Key>
|
|
</>
|
|
),
|
|
label: t("Small header"),
|
|
},
|
|
{
|
|
shortcut: (
|
|
<>
|
|
<Key>Ctrl</Key> + <Key>⇧</Key> + <Key>\</Key>
|
|
</>
|
|
),
|
|
label: t("Code block"),
|
|
},
|
|
{
|
|
shortcut: (
|
|
<>
|
|
<Key>{metaDisplay}</Key> + <Key>b</Key>
|
|
</>
|
|
),
|
|
label: t("Bold"),
|
|
},
|
|
{
|
|
shortcut: (
|
|
<>
|
|
<Key>{metaDisplay}</Key> + <Key>i</Key>
|
|
</>
|
|
),
|
|
label: t("Italic"),
|
|
},
|
|
{
|
|
shortcut: (
|
|
<>
|
|
<Key>{metaDisplay}</Key> + <Key>u</Key>
|
|
</>
|
|
),
|
|
label: t("Underline"),
|
|
},
|
|
{
|
|
shortcut: (
|
|
<>
|
|
<Key>{metaDisplay}</Key> + <Key>d</Key>
|
|
</>
|
|
),
|
|
label: t("Strikethrough"),
|
|
},
|
|
{
|
|
shortcut: (
|
|
<>
|
|
<Key>{metaDisplay}</Key> + <Key>k</Key>
|
|
</>
|
|
),
|
|
label: t("Link"),
|
|
},
|
|
{
|
|
shortcut: (
|
|
<>
|
|
<Key>{metaDisplay}</Key> + <Key>z</Key>
|
|
</>
|
|
),
|
|
label: t("Undo"),
|
|
},
|
|
{
|
|
shortcut: (
|
|
<>
|
|
<Key>{metaDisplay}</Key> + <Key>⇧</Key> + <Key>z</Key>
|
|
</>
|
|
),
|
|
label: t("Redo"),
|
|
},
|
|
],
|
|
},
|
|
{
|
|
title: t("Lists"),
|
|
items: [
|
|
{
|
|
shortcut: (
|
|
<>
|
|
<Key>Ctrl</Key> + <Key>⇧</Key> + <Key>7</Key>
|
|
</>
|
|
),
|
|
label: t("Todo list"),
|
|
},
|
|
{
|
|
shortcut: (
|
|
<>
|
|
<Key>Ctrl</Key> + <Key>⇧</Key> + <Key>8</Key>
|
|
</>
|
|
),
|
|
label: t("Bulleted list"),
|
|
},
|
|
{
|
|
shortcut: (
|
|
<>
|
|
<Key>Ctrl</Key> + <Key>⇧</Key> + <Key>9</Key>
|
|
</>
|
|
),
|
|
label: t("Ordered list"),
|
|
},
|
|
{
|
|
shortcut: <Key>Tab</Key>,
|
|
label: t("Indent list item"),
|
|
},
|
|
{
|
|
shortcut: (
|
|
<>
|
|
<Key>⇧</Key> + <Key>Tab</Key>
|
|
</>
|
|
),
|
|
label: t("Outdent list item"),
|
|
},
|
|
{
|
|
shortcut: (
|
|
<>
|
|
<Key>Alt</Key> + <Key>↑</Key>
|
|
</>
|
|
),
|
|
label: t("Move list item up"),
|
|
},
|
|
{
|
|
shortcut: (
|
|
<>
|
|
<Key>Alt</Key> + <Key>↓</Key>
|
|
</>
|
|
),
|
|
label: t("Move list item down"),
|
|
},
|
|
],
|
|
},
|
|
{
|
|
title: "Markdown",
|
|
items: [
|
|
{
|
|
shortcut: (
|
|
<>
|
|
<Key>#</Key> <Key>Space</Key>
|
|
</>
|
|
),
|
|
label: t("Large header"),
|
|
},
|
|
{
|
|
shortcut: (
|
|
<>
|
|
<Key>##</Key> <Key>Space</Key>
|
|
</>
|
|
),
|
|
label: t("Medium header"),
|
|
},
|
|
{
|
|
shortcut: (
|
|
<>
|
|
<Key>###</Key> <Key>Space</Key>
|
|
</>
|
|
),
|
|
label: t("Small header"),
|
|
},
|
|
{
|
|
shortcut: (
|
|
<>
|
|
<Key>1.</Key> <Key>Space</Key>
|
|
</>
|
|
),
|
|
label: t("Numbered list"),
|
|
},
|
|
{
|
|
shortcut: (
|
|
<>
|
|
<Key>-</Key> <Key>Space</Key>
|
|
</>
|
|
),
|
|
label: t("Bulleted list"),
|
|
},
|
|
{
|
|
shortcut: (
|
|
<>
|
|
<Key>[ ]</Key> <Key>Space</Key>
|
|
</>
|
|
),
|
|
label: t("Todo list"),
|
|
},
|
|
{
|
|
shortcut: (
|
|
<>
|
|
<Key>></Key> <Key>Space</Key>
|
|
</>
|
|
),
|
|
label: t("Blockquote"),
|
|
},
|
|
{
|
|
shortcut: <Key>---</Key>,
|
|
label: t("Horizontal divider"),
|
|
},
|
|
{
|
|
shortcut: <Key>{"```"}</Key>,
|
|
label: t("Code block"),
|
|
},
|
|
{
|
|
shortcut: <Key>{":::"}</Key>,
|
|
label: t("Info notice"),
|
|
},
|
|
{
|
|
shortcut: "_italic_",
|
|
label: t("Italic"),
|
|
},
|
|
{
|
|
shortcut: "**bold**",
|
|
label: t("Bold"),
|
|
},
|
|
{
|
|
shortcut: "~~strikethrough~~",
|
|
label: t("Strikethrough"),
|
|
},
|
|
{
|
|
shortcut: "`code`",
|
|
label: t("Inline code"),
|
|
},
|
|
{
|
|
shortcut: "==highlight==",
|
|
label: t("Highlight"),
|
|
},
|
|
],
|
|
},
|
|
],
|
|
[t]
|
|
);
|
|
|
|
const [searchTerm, setSearchTerm] = React.useState("");
|
|
|
|
const handleChange = React.useCallback((event) => {
|
|
setSearchTerm(event.target.value);
|
|
}, []);
|
|
|
|
const handleKeyDown = React.useCallback((event) => {
|
|
if (event.currentTarget.value && event.key === "Escape") {
|
|
event.preventDefault();
|
|
event.stopPropagation();
|
|
setSearchTerm("");
|
|
}
|
|
}, []);
|
|
|
|
return (
|
|
<Flex column>
|
|
<InputSearch
|
|
onChange={handleChange}
|
|
onKeyDown={handleKeyDown}
|
|
value={searchTerm}
|
|
/>
|
|
{categories.map((category, x) => {
|
|
const filtered = searchTerm
|
|
? category.items.filter((item) =>
|
|
item.label.toLowerCase().includes(searchTerm.toLowerCase())
|
|
)
|
|
: category.items;
|
|
|
|
if (!filtered.length) {
|
|
return null;
|
|
}
|
|
|
|
return (
|
|
<React.Fragment key={x}>
|
|
<Header>{category.title}</Header>
|
|
<List>
|
|
{filtered.map((item) => (
|
|
<React.Fragment key={item.label}>
|
|
<Keys>
|
|
<span>{item.shortcut}</span>
|
|
</Keys>
|
|
<Label>{item.label}</Label>
|
|
</React.Fragment>
|
|
))}
|
|
</List>
|
|
</React.Fragment>
|
|
);
|
|
})}
|
|
</Flex>
|
|
);
|
|
}
|
|
|
|
const Header = styled.h2`
|
|
font-size: 15px;
|
|
font-weight: 500;
|
|
margin-top: 2em;
|
|
`;
|
|
|
|
const List = styled.dl`
|
|
font-size: 14px;
|
|
width: 100%;
|
|
overflow: hidden;
|
|
padding: 0;
|
|
margin: 0;
|
|
`;
|
|
|
|
const Keys = styled.dt`
|
|
float: right;
|
|
width: 45%;
|
|
margin: 0 0 10px;
|
|
clear: left;
|
|
text-align: right;
|
|
font-size: 12px;
|
|
color: ${(props) => props.theme.textSecondary};
|
|
display: flex;
|
|
align-items: center;
|
|
justify-content: flex-end;
|
|
`;
|
|
|
|
const Label = styled.dd`
|
|
float: left;
|
|
width: 55%;
|
|
margin: 0 0 10px;
|
|
display: flex;
|
|
align-items: center;
|
|
color: ${(props) => props.theme.textSecondary};
|
|
`;
|
|
|
|
export default KeyboardShortcuts;
|