Skip to content

[add] document copy and paste behavior #41

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
serhiipylypchuk1991 wants to merge 2 commits into
base: sp-next-v-2-1
Choose a base branch
from
Open

[add] document copy and paste behavior #41

Changes from 1 commit
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
4620b96
[add] document copy and paste behavior
serhiipylypchuk1991 May 22, 2026
575a11d
[update] address review on copy and paste section
serhiipylypchuk1991 May 22, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
19 changes: 19 additions & 0 deletions docs/index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -85,6 +85,25 @@ The RichText editor supports [parsing](api/methods/set-value.md) and [serializat
![Text format](./assets/richtext/text_format.png)
</div>

## Copy and paste

The RichText editor supports clipboard operations through standard system shortcuts (`Ctrl+C` / `Ctrl+X` / `Ctrl+V` on Windows/Linux, `⌘C` / `⌘X` / `⌘V` on macOS), the corresponding [toolbar](api/config/toolbar.md) buttons, and the [menubar](api/config/menubar.md) entries.
Comment thread
serhiipylypchuk1991 marked this conversation as resolved.
Outdated

When content is copied or cut, RichText writes two representations to the system clipboard:

- a **plain text** version for compatibility with simple targets (terminals, code editors, plain inputs)
- an **HTML** version that carries all inline and block formatting (bold, italic, underline, strikethrough, font family, font size, text and background color, headings, blockquotes, lists, alignment, indentation, line height, links, and images)

On paste, the editor reads the HTML version when it is available and falls back to plain text otherwise. This means that:

- Copying between two RichText instances (in the same document or on different pages) preserves the original formatting.
- Pasting from external sources that publish HTML to the clipboard (most browsers, word processors, and editors) also preserves the recognized formatting. Styles that have no direct counterpart in RichText are dropped during normalization.
Comment thread
serhiipylypchuk1991 marked this conversation as resolved.
Outdated
- Pasting from a plain-text source produces a plain paragraph, as expected.
Comment thread
serhiipylypchuk1991 marked this conversation as resolved.
Outdated

:::note
The toolbar **Paste** button uses the asynchronous Clipboard API, which exposes plain text only. To paste formatted content, use the `Ctrl+V` / `⌘V` shortcut, which receives the full HTML payload directly from the browser's clipboard event.
:::

## Keyboard shortcuts

The RichText editor supports a set of common keyboard shortcuts for faster formatting and editing. The shortcuts follow platform conventions and are available on both **Windows/Linux** (`Ctrl`) and **macOS** (`⌘`).
Expand Down