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)