diff --git a/packages/paste-website/src/pages/components/keyboard-key/index.mdx b/packages/paste-website/src/pages/components/keyboard-key/index.mdx index cf9163d5af..a225938902 100644 --- a/packages/paste-website/src/pages/components/keyboard-key/index.mdx +++ b/packages/paste-website/src/pages/components/keyboard-key/index.mdx @@ -1,7 +1,6 @@ import { KeyboardKey, KeyboardKeyGroup, useKeyCombination, useKeyCombinations } from "@twilio-paste/keyboard-key"; import { Callout, CalloutHeading, CalloutText } from "@twilio-paste/callout"; import { Anchor } from "@twilio-paste/anchor"; -import { List, ListItem } from "@twilio-paste/list"; import { Box } from "@twilio-paste/box"; import { Button } from "@twilio-paste/button"; import { useMenuState, Menu, MenuButton, MenuItem } from "@twilio-paste/menu"; @@ -179,14 +178,9 @@ Keyboard Key is mainly a presentational component, and can't detect operating sy When writing out keys: - - Use title case. Example: “Caps Lock”, not “Caps lock”. - - For modifier keys like Control, Command, and Option, spell out the key instead of using abbreviations or symbols. - Example: “Control”, not “Ctrl” or “^”. Use the abbreviation only when space is limited. - - Use “Enter” instead of “Return”. - +- Use title case. Example: “Caps Lock”, not “Caps lock”. +- For modifier keys like Control, Command, and Option, spell out the key instead of using abbreviations or symbols. Example: “Control”, not “Ctrl” or “^”. Use the abbreviation only when space is limited. +- Use “Enter” instead of “Return”. ## Common keyboard shortcuts @@ -365,31 +359,15 @@ The following keyboard commands should be used in any context where the actions These keyboard commands should be avoided since they're used by operating systems or assistive technologies: - - - Any modifier keys (a keyboard key that changes the function of other keys when pressed together) + any of Tab, Enter,{" "} - Space, or Escape. - - - Alt + a function key. - - - Caps Lock + any other combination of keys. - - - Insert + any combination of other keys. - - - Scroll Lock + any combination of other keys. - - - - Control - Option - {" "} - + any combination of other keys. - - +- Any modifier keys (a keyboard key that changes the function of other keys when pressed together) + any of Tab, Enter, Space, or Escape. +- Alt + a function key. +- Caps Lock + any other combination of keys. +- Insert + any combination of other keys. +- Scroll Lock + any combination of other keys. +- + Control + Option + + any combination of other keys. Read more about other conflicts with browsers and international keyboards in [W3C's guide](https://www.w3.org/WAI/ARIA/apg/practices/keyboard-interface/#keyboardshortcuts). @@ -410,5 +388,9 @@ Read more about other conflicts with browsers and international keyboards in [W3 /> - +