Keyboard Shortcuts

useKeyboardShortcuts registers global keyboard event handlers for common whiteboard operations.

Signature

function useKeyboardShortcuts(): void;

No return value — the hook only registers side effects. Call it once in your whiteboard component.

Usage

import { useKeyboardShortcuts } from '@hfu.digital/boardkit-react';

function Whiteboard() {
    useKeyboardShortcuts();

    return <BoardCanvas />;
}

Shortcut Reference

General

Tool Switching (Number Keys)

Behavior Notes

• Shortcuts are disabled when the focus is in an <input>, <textarea>, or contentEditable element
• Copy/paste uses an internal clipboard (not the system clipboard) for element serialization
• Paste places elements at the center of the current viewport
• Duplicate offsets elements by (+20, +20) pixels from the original position
• Ctrl and Cmd (Meta) are treated equivalently for macOS compatibility