Kbd
This component is used to display which key or combination of keys performs a given action.
Press ⌘ Cmd + K to search.
import * as React from 'react';
import { Kbd, KbdKeys } from '@itwin/itwinui-react';
export default () => {
return (
<p>
Press <Kbd>{KbdKeys.Command}</Kbd> + <Kbd>K</Kbd> to search.
</p>
);
};
Usage
The <Kbd>
component is a styled wrapper around the <kbd>
HTML element.
You can pass custom key(s) as children
.
You can also use the KbdKeys
object which includes a convenient set of constants for common modifier keys.
List of supported keys:
KbdKeys.Command
(⌘ Cmd)KbdKeys.Shift
(⇧ Shift)KbdKeys.Backspace
(⌫ Backspace)KbdKeys.Enter
(↵ Enter)KbdKeys.Eject
(⏏ Eject)KbdKeys.Control
(Ctrl)KbdKeys.Windows
(⊞ Win)KbdKeys.Apple
()KbdKeys.Option
(⌥ Option)KbdKeys.Left
(←)KbdKeys.Up
(↑)KbdKeys.Right
(→)KbdKeys.Down
(↓)
Important: Some of the keys are specific to the operating system and may not be available universally.
Props
Prop | Description | Default |
---|---|---|
children | Content of the key to be passed as children. Must be a string or one of the KbdKeys .string | |
as | "symbol" | "object" | "kbd" | "a" | "abbr" | "address" | "area" | "article" | "aside" | "audio" | "b" | "base" | "bdi" | "bdo" | "big" | "blockquote" | "body" | "br" | "button" | "canvas" | ... 158 more ... | FunctionComponent<...> |