Toolbelt.Blazor.CopyButtonizer 1.0.0

dotnet add package Toolbelt.Blazor.CopyButtonizer --version 1.0.0                
NuGet\Install-Package Toolbelt.Blazor.CopyButtonizer -Version 1.0.0                
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Toolbelt.Blazor.CopyButtonizer" Version="1.0.0" />                
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add Toolbelt.Blazor.CopyButtonizer --version 1.0.0                
#r "nuget: Toolbelt.Blazor.CopyButtonizer, 1.0.0"                
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install Toolbelt.Blazor.CopyButtonizer as a Cake Addin
#addin nuget:?package=Toolbelt.Blazor.CopyButtonizer&version=1.0.0

// Install Toolbelt.Blazor.CopyButtonizer as a Cake Tool
#tool nuget:?package=Toolbelt.Blazor.CopyButtonizer&version=1.0.0                

Blazor Copy Buttonizer NuGet Package

Summary

This is a component for Blazor apps to append "Copy to clipboard" button.

movie.1

Installation

  1. Add the "Toolbelt.Blazor.CopyButtonizer" NuGet package to your Blazor application project.
dotnet add package Toolbelt.Blazor.CopyButtonizer
  1. To be convinience, open the Toolbelt.Blazor.CopyButtonizer name space globally.
@* _Import.razor *@
...
@* 👇 Open this name space. *@
@using Toolbelt.Blazor.CopyButtonizer

Usage

Surround the contents what you want to add "Copy to clipboard" button with a <CopyButtonize> component.

@* *.razor *@
...
<CopyButtonize>
  <input type="text" .../>
</CopyButtonize>
...

After doing that, the button to copy to the clipboard will be appended to the child's contents, which the CopyButtonize component surrounds.

fig.1

API

CopyButtonize component exposes the following properties.

Property Name Type Description
Title string Specify the tooltip text of the "copy to clipboard" button.
Position CopyButtonPosition Specify the layout position of the "copy to clipboard" button. (The default value is "Bottom".)
Class string Specify the CSS class name that will apply to the container element of the CopyButtonize component.
ContainerStyle string Specify the inline styles that will apply to the container element of the CopyButtonize component.
ButtonStyle string Specify the inline styles that will apply to the button element of the CopyButtonize component.
Copied EventCallback Specify the event handler when copying to clipboard was fired.

Configure default settings

You can configure the default settings of the CopyButtonize component globally in your start-up code. (See the following example.)

// Program.cs

// 👇 Open these name spaces.
using Toolbelt.Blazor.CopyButtonizer;
using Toolbelt.Blazor.Extensions.DependencyInjection;
...
var builder = WebAssemblyHostBuilder.CreateDefault(args);
...

// 👇 Call "AddCopyButtonizeOptions()" method 
//    to configure the "CopyButtonize" component's options globally.
builder.Services.AddCopyButtonizeOptions(options =>
{
    options.GetTitle = services => "Copy to clipboard.";
    options.GetPosition = services => CopyButtonPosition.Top;
});
...

Supported versions

Both Blazor WebAssembly and Blazor Server apps on .NET 6 or later are supported.

Release notes

The release notes is here.

License

Mozilla Public License Version 2.0

Product Compatible and additional computed target framework versions.
.NET net6.0 is compatible.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 was computed.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 was computed.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
1.0.0 731 5/1/2022

v.1.0.0
- Initial release.