1ecc20e1ec
Wrap all keyboard shortcut references in <kbd> tags in user guide, reference, and development docs across all 7 locales (en, de, es, fr, it, pl, ru). Tables, inline prose, and parenthetical hints.
90 lines
4.1 KiB
Markdown
90 lines
4.1 KiB
Markdown
---
|
||
title: Context Menu
|
||
description: Right-click context menu actions in OpenPencil — clipboard, z-order, grouping, components, and more.
|
||
---
|
||
|
||
# Context Menu
|
||
|
||
Right-click on the canvas to open the context menu. If you right-click on a node, it is selected first. Right-clicking on empty canvas clears the selection.
|
||
## Copy/Paste as
|
||
|
||
The **Copy/Paste as** submenu offers additional clipboard formats for the selected node(s):
|
||
|
||
| Action | Shortcut (Mac) | Shortcut (Win/Linux) |
|
||
|--------|----------------|----------------------|
|
||
| Copy as text | — | — |
|
||
| Copy as SVG | — | — |
|
||
| Copy as PNG | <kbd>⇧</kbd><kbd>⌘</kbd><kbd>C</kbd> | <kbd>Shift</kbd> + <kbd>Ctrl</kbd> + <kbd>C</kbd> |
|
||
| Copy as JSX | — | — |
|
||
|
||
- **Copy as text** — copies visible text content from the selection
|
||
- **Copy as SVG** — copies the node tree as SVG markup
|
||
- **Copy as PNG** — renders at 2× and places on the system clipboard (paste into Slack, Notion, etc.)
|
||
- **Copy as JSX** — copies the OpenPencil JSX representation for use with `renderJsx()`
|
||
|
||
## Clipboard Actions
|
||
|
||
| Action | Shortcut (Mac) | Shortcut (Win/Linux) |
|
||
|--------|----------------|----------------------|
|
||
| Copy | <kbd>⌘</kbd><kbd>C</kbd> | <kbd>Ctrl</kbd> + <kbd>C</kbd> |
|
||
| Cut | <kbd>⌘</kbd><kbd>X</kbd> | <kbd>Ctrl</kbd> + <kbd>X</kbd> |
|
||
| Paste here | <kbd>⌘</kbd><kbd>V</kbd> | <kbd>Ctrl</kbd> + <kbd>V</kbd> |
|
||
| Duplicate | <kbd>⌘</kbd><kbd>D</kbd> | <kbd>Ctrl</kbd> + <kbd>D</kbd> |
|
||
| Delete | ⌫ | <kbd>Backspace</kbd> / Delete |
|
||
|
||
Clipboard actions are disabled when nothing is selected (except Paste, which is available when the clipboard has content).
|
||
|
||
## Z-Order
|
||
|
||
| Action | Shortcut |
|
||
|--------|----------|
|
||
| Bring to front | ] |
|
||
| Send to back | [ |
|
||
|
||
Moves the selected node to the top or bottom of its parent's child list.
|
||
|
||
## Grouping
|
||
|
||
| Action | Shortcut (Mac) | Shortcut (Win/Linux) |
|
||
|--------|----------------|----------------------|
|
||
| Group | <kbd>⌘</kbd><kbd>G</kbd> | <kbd>Ctrl</kbd> + <kbd>G</kbd> |
|
||
| Ungroup | <kbd>⇧</kbd><kbd>⌘</kbd><kbd>G</kbd> | <kbd>Shift</kbd> + <kbd>Ctrl</kbd> + <kbd>G</kbd> |
|
||
| Add auto layout | <kbd>⇧</kbd><kbd>A</kbd> | <kbd>Shift</kbd> + <kbd>A</kbd> |
|
||
|
||
- **Group** requires 2 or more selected nodes
|
||
- **Ungroup** appears when a group is selected — children are reparented to the group's parent
|
||
- **Add auto layout** wraps the selection in a new [auto layout](./auto-layout) frame
|
||
|
||
## Component Actions
|
||
|
||
Component actions are displayed in purple to match the component color theme.
|
||
|
||
| Action | Shortcut (Mac) | Shortcut (Win/Linux) | Available on |
|
||
|--------|----------------|----------------------|--------------|
|
||
| Create component | <kbd>⌥</kbd><kbd>⌘</kbd><kbd>K</kbd> | <kbd>Ctrl</kbd> + <kbd>Alt</kbd> + <kbd>K</kbd> | Frames, groups, multi-selection |
|
||
| Create component set | <kbd>⇧</kbd><kbd>⌘</kbd><kbd>K</kbd> | <kbd>Shift</kbd> + <kbd>Ctrl</kbd> + <kbd>K</kbd> | 2+ selected components |
|
||
| Create instance | — | — | Components (no shortcut) |
|
||
| Go to main component | — | — | Instances |
|
||
| Detach instance | <kbd>⌥</kbd><kbd>⌘</kbd><kbd>B</kbd> | <kbd>Ctrl</kbd> + <kbd>Alt</kbd> + <kbd>B</kbd> | Instances |
|
||
|
||
See [Components](./components) for details on the component workflow.
|
||
|
||
## Visibility & Lock
|
||
|
||
| Action | Shortcut (Mac) | Shortcut (Win/Linux) |
|
||
|--------|----------------|----------------------|
|
||
| Hide / Show | <kbd>⇧</kbd><kbd>⌘</kbd><kbd>H</kbd> | <kbd>Shift</kbd> + <kbd>Ctrl</kbd> + <kbd>H</kbd> |
|
||
| Lock / Unlock | <kbd>⇧</kbd><kbd>⌘</kbd><kbd>L</kbd> | <kbd>Shift</kbd> + <kbd>Ctrl</kbd> + <kbd>L</kbd> |
|
||
|
||
The label toggles based on the node's current state (e.g., "Hide" for a visible node, "Show" for a hidden one).
|
||
|
||
## Move to Page
|
||
|
||
The **Move to page** submenu lists all pages except the current one. Select a page to reparent the selected nodes under that page's canvas.
|
||
|
||
## Tips
|
||
|
||
- Right-clicking empty canvas gives you access to Paste — useful for placing content at a specific location.
|
||
- Component actions only appear when relevant (e.g., "Create instance" only for component nodes).
|
||
- The context menu mirrors the keyboard shortcuts — it's a good way to discover shortcuts you don't know yet.
|