ClipLazor 3.0.2

ClipLazor: Clipboard API Interop for Blazor

ClipLazor is a library that provides interop for the Clipboard API in Blazor applications, allowing you to easily interact with the clipboard.

Installation

1. Install ClipLazor with dotnet cli in your Blazor app.

dotnet add package ClipLazor 

2. Register the service to the IoC container using AddClipboard method:

using ClipLazor.Extention;

// Inside your ConfigureServices method
builder.Service.AddClipboard();

3.Add this script tag in your root file _Host.cshtml or App.razor for Blazor Server Apps and index.html for Blazor WebAssembly Apps:

<script src="_framework/blazor.server.js"></script>
<script src="_content/ClipLazor/clipboard.min.js"></script>

Usage

After ClipLazor being installed, you can inject it in your razor file using IClipLazor interface:

@using ClipLazor.Components;
@inject IClipLazor Clipboard

Checking Browser Support

You can check if the browser supports the Clipboard API with the IsClipboardSupported() asynchronous method:

bool isSupported = await Clipbaord.IsClipboardSupported();

⚠️ Most of non-Chromium browsers (Firefox or safari) does not support clipboard api permissions so the IsClipboardSupported() and Clipboard.IsPermitted(PermissionCommand.Write), Clipboard.IsPermitted(PermissionCommand.Read) will always return true. Please check this mdn

Checking Permissions

The Clipboard API requires user permission to read and write to the clipboard. Use the IsPermitted() asynchronous method with the PermissionCommand enum to check read or write permission:

bool isWritePermitted = await Clipboard.IsPermitted(PermissionCommand.Write);
bool isReadPermitted = await Clipboard.IsPermitted(PermissionCommand.Read);

Read And Write Text

1.To copy a text to the clipboard use WriteTextAsync() async method and pass the text(:warning: pass the argument by ReadOnlyMemory). The method return true if the copy operation is successful; otherwise, false:

string txt = string.Empty;
if(isSupported && txt.Length > 0)
{
    if (isWritePermitted)
    {
        var isCopied = await Clipboard.WriteTextAsync(txt.AsMemory());
        if (isCopied)
        {
            msg = "Text Copied";
        }
        else
        {
            msg = "Couldn't copy the text!.";
        }
    }
}

2. To paste a text from the clipboard use 'ReadTextAsync()' async method. if the paste operation was successed the method ruturns the text string; otherwise null:

string pastedTxt = string.Empty;
if(isSupported && isReadPermitted)
{
    var pastedText = await Clipboard.ReadTextAsync();
    if (pastedText is not null)
    {
        msg = "Text Pasted";
        pastedTxt = pastedText;
    }
    else
    {
        msg = "Couldn't paste the text!.";
    }
}

Read And Write Data

❗ When you work with data to copy to the clipboard or paste from it, the MIME Type has to be specified. Note that not all MIME types supported by the clipboard api.

Common Supported Mime Types:

• "text/plain"
• "text/html"
• "text/uri-list"
• "image/png"

1. To copy data to the clipboard use WriteDataAsync async method. pass the array buffer of the data and it's associated MIME Type. This method will return true if the copy operation is successful; otherwise, false:

 byte[] imgArray = Convert.FromBase64String(imageToCopy);

 if(imgArray.Length > 0 && isWritePermitted)
 {
     var isDataCopied = await Clipboard.WriteDataAsync(imgArray, "image/png");

     if (isDataCopied)
     {
         dmsg = "Image Copied!";
     }
     else
     {
         dmsg = "Failed to copy the image!.";
     }
 }

2. To paste the data from the clipboard use ReadDataAsync async method and pass the MIME Type argument, the method will return Memory<byte> of the data; or an empty one:

if (isReadPermitted)
{
    var pastedData = await Clipboard.ReadDataAsync("image/png");
    if (!pastedData.IsEmpty)
    {
        pastedImg = Convert.ToBase64String(pastedData.ToArray());
        dmsg = "Image Pasted";

    }
    else
    {
        dmsg = "Couldn't paste the image";
    }
}

📄 See the full example code.

License

MIT License