Skip to content

Commit 816b55b

Browse files
committed
docs(svg+docc): note embedded SVG text is not selectable
1 parent 3997b7d commit 816b55b

File tree

1 file changed

+4
-0
lines changed

1 file changed

+4
-0
lines changed

design-system.docc/svg/svg-docc-considerations.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -17,6 +17,10 @@ Use this page as the “gotchas” checklist before shipping new SVG diagrams.
1717
## Interaction Constraints
1818

1919
- No JavaScript. DocC does not execute scripts inside SVGs.
20+
- Text selection: **SVG text is not reliably selectable when embedded in DocC**.
21+
- Opening the raw `.svg` URL may allow selecting `<text>`.
22+
- Inside DocC pages, SVGs are typically embedded as images (`<img>`), so the browser treats the SVG like an image surface and text selection/copy is not exposed.
23+
- If users need copyable text (commands, URLs, API names), put it in Markdown/code blocks near the SVG instead of relying on `<text>` inside the SVG.
2024
- Hover is best-effort:
2125
- many renderers treat SVGs as images and do not deliver reliable `:hover` state
2226
- touch devices may never trigger hover

0 commit comments

Comments
 (0)