SidebarLayout

ClipboardCopy

Umschließt einen klickbaren Inhalt und kopiert beim Klick in die Zwischenablage. Der Kopiervorgang startet direkt im Browser, der Inhalt wird erst danach über GetContent vom Server geholt – so bleibt die Benutzeraktion erhalten, die Safari verlangt.

Text kopieren

GetContent liefert den aktuellen Wert, OnCopied wechselt das Icon auf ein Häkchen und zählt mit.

Wert: Hallo von Onesown! – Kopiervorgänge: 0

Mit HTML (IncludeHtml)

IncludeHtml="true" schreibt zusätzlich ClipboardContent.Html. Word, Outlook oder Teams fügen die Tabelle formatiert ein, einfache Textfelder erhalten nur PlainText. Der Schalter ändert IncludeHtml zur Laufzeit.

IncludeHtml: True – Letzter Vorgang: –

Icon-Button neben langem Inhalt

Beliebiger Inhalt als ChildContent, hier ein Icon-Button neben einem Code-Snippet, das auf schmalen Bildschirmen umbricht.

<ClipboardCopy GetContent="InhaltAsync" OnCopied="KopiertAsync"><Button Icon="content_copy" IconOnly="true" Title="Kopieren" /></ClipboardCopy>

Snippet kopiert: False

Fehlerbehandlung (OnCopyFailed)

Wirft GetContent eine Ausnahme (hier) oder liefert null, meldet OnCopyFailed die Fehlermeldung.

Eingebaut in andere Komponenten

TextBox ShowCopyButton="true" und der Kopier-Button von JsonView verwenden ClipboardCopy intern.

Wert: Kopier mich

SKILL.md – Clipboardcopy
---
name: ClipboardCopy
description: Onesown Blazor Komponente ClipboardCopy (Common). Verwende diesen Skill wenn du die ClipboardCopy-Komponente verwenden, konfigurieren oder debuggen moechtest.
---

# ClipboardCopy

**Namespace:** `Onesown.Blazor.Components`  
**Kategorie:** Common  
**Basisklasse:** `IAsyncDisposable`  

Startet einen Zwischenablagevorgang direkt im Browser und ermittelt dessen Inhalt anschließend asynchron. Dadurch bleibt die für Safari erforderliche Benutzeraktion auch bei Blazor-Server-Aufrufen erhalten.

**Live-Demo:** https://components.schini.com/demo/clipboardcopy  

## Parameter

| Parameter | Typ | Standard | Beschreibung |
|---|---|---|---|
| ``ChildContent`` | ``RenderFragment`` |  | Klickbarer Inhalt, der den Kopiervorgang auslöst, z. B. ein Button mit Icon content_copy. |
| ``GetContent`` | ``Func<Task<ClipboardContent>>`` |  | Pflicht: Ermittelt den zu kopierenden Inhalt nach dem Benutzerklick. Ein Ergebnis null oder eine Ausnahme löst OnCopyFailed aus. |
| ``IncludeHtml`` | ``bool`` |  | Legt fest, ob zusätzlich zur Textdarstellung HTML (ClipboardContent.Html) in die Zwischenablage geschrieben wird. Standard: false. |
| ``OnCopied`` | ``EventCallback`` |  | Wird nach erfolgreichem Kopieren ausgelöst. |
| ``OnCopyFailed`` | ``EventCallback<string>`` |  | Wird bei einem fehlgeschlagenen Kopiervorgang mit der Browserfehlermeldung ausgelöst. |

## Hinweise

- Umschließt beliebigen klickbaren Inhalt (meist Button oder Icon-Button); ein Klick darauf startet den Kopiervorgang
- Erzeugt kein eigenes Layout-Element: Der Wrapper ist ein span mit display:contents (class, data-*, aria-*, id werden daran durchgereicht)
- GetContent ist Pflicht und liefert den Inhalt erst nach dem Klick (ClipboardContent mit PlainText und optional Html)
- IncludeHtml="true" schreibt zusätzlich HTML (z. B. für Word, Outlook, Teams); einfache Textfelder erhalten PlainText
- OnCopied für Rückmeldung (z. B. Häkchen-Icon), OnCopyFailed erhält die Fehlermeldung des Browsers
- Der Klick wird im Browser abgefangen (preventDefault/stopPropagation): @onclick-Handler des Inhalts werden nicht ausgelöst
- Tastatur: Enter/Leertaste auf einem enthaltenen Button lösen den Kopiervorgang wie ein Klick aus
- Für reines Kopieren ohne Komponente: JS.CopyToClipboard(text) bzw. JS.CopyHtmlToClipboard(text, html)


Die Verbindung zum Server ist unterbrochen. Verbinde neu …

Neu verbinden hat nicht geklappt. Nächster Versuch in Sekunden.

Keine Verbindung zum Server. Bitte erneut versuchen oder die Seite neu laden.

Der Server hat die Sitzung angehalten.

Die Sitzung ließ sich nicht fortsetzen. Bitte erneut versuchen oder die Seite neu laden.