Use the new Angular Clipboard CDK to interact with the clipboard

Modified November 28, 2023

Tim Deschryver

timdeschryver.dev

The helium-barbell (v9.0.0-next.1) release brings us a new CDK clipboard module to interact with the clipboard. In this post, we'll explore how to use the new CDK with some examples.

format_quote

The Component Dev Kit (CDK) is a set of tools that implement common interaction patterns whilst being unopinionated about their presentation. It represents an abstraction of the core functionalities found in the Angular Material library, without any styling specific to Material Design. Think of the CDK as a blank state of well-tested functionality upon which you can develop your own bespoke components.

Import the ClipboardModule link

The first step to use the CDK is to import the ClipboardModule from @angular/cdk/clipboard and add it to the imports declaration.

 content_paste
import { NgModule } from '@angular/core'
import { BrowserModule } from '@angular/platform-browser'
import { ClipboardModule } from '@angular/cdk/clipboard'
 
import { AppComponent } from './app.component'
 
@NgModule({
  imports: [BrowserModule, ClipboardModule],
  declarations: [AppComponent],
  bootstrap: [AppComponent],
})
export class AppModule {}

Using the cdkCopyToClipboard attribute link

After the ClipboardModule is imported, we're good to go. The only thing needed to copy content is the cdkCopyToClipboard attribute. It's possible to add it to any element, and when the element is clicked it will save the content to your clipboard.

 content_paste
<button cdkCopyToClipboard="👋 You copied me!">Click to copy</button>

Copying a static string is boring, but we can also use a property binding to copy the result of an expression.

 content_paste
export class AppComponent {
  code = 'AAA-BBB-CCC';
}

 content_paste
<input disabled [value]="code" /> <button [cdkCopyToClipboard]="code">Copy coupon code</button>

Even more fun is to bind it to a function where we can modify the content.

 content_paste
export class AppComponent {
  value = '';
 
  copy(value) {
    return `${value}\n\ncopied from timdeschryver.dev`;
  }
}

 content_paste
<textarea [(ngModel)]="value"></textarea>
<button [cdkCopyToClipboard]="copy(value)">Copy content</button>

Using the Clipboard service link

Using the cdkCopyToClipboard attribute is great to give users the possibility to copy content from a page. But it doesn't allow us, as developers, to copy content programmatically. This is where the Clipboard service comes into play. By using the copy(content) method we can copy content to the clipboard.

 content_paste
<button (click)="generateId()">Generate Id</button>

 content_paste
export class AppComponent {
  constructor(private clipboard: Clipboard) {}
 
  generateId() {
    const id = 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, (c) => {
      const r = (Math.random() * 16) | 0,
        v = c == 'x' ? r : (r & 0x3) | 0x8
      return v.toString(16)
    })
 
    this.clipboard.copy(id)
 
    alert(`Id "${id}" is generated and copied to the clipboard`)
  }
}

Playground link

Implementation details link

Internally, the PendingCopy is used to copy content to the clipboard. This class creates an invisible textarea in the DOM with the content as its value. When the copy() method is used, it will move the focus to the invisible textarea and use the native execCommand('copy') to copy the content to the clipboard. As the last step, it will re-focus the previously selected element.

For the ones interested, the native Clipboard API can also cut content and read the current clipboard value.

Incoming links

• Google Maps is now an Angular component

Feel free to update this blog post on GitHub, thanks in advance!

Support me

I appreciate it if you would support me if have you enjoyed this post and found it useful, thank you in advance.

Share this post