Back to Shark UI

Clipboard

docs/components/clipboard

latest7.3 KB
Original Source

Sections

Components

Utilities

Forms

Hooks

Clipboard

Copy Markdown

Copy text to the clipboard.

DocsAPI

PreviewCode

Installation#

CLIManual

pnpmbunnpmyarn

pnpm dlx shadcn@latest add @shark/clipboard

Anatomy#

Clipboard
├── ClipboardTrigger
│ └── ClipboardIndicator
├── ClipboardInput
└── ClipboardValue

Usage#

import { 
  Clipboard, 
  ClipboardTrigger, 
  ClipboardIndicator 
} from "@/components/ui/clipboard";
<Clipboard value="https://x.com/vinihvc">
  <ClipboardTrigger asChild>
    <Button size="icon-md">
      <ClipboardIndicator />
    </Button>
  </ClipboardTrigger>
</Clipboard>

Controlled#

PreviewCode

Change URL

Examples#

Icon Only#

PreviewCode

Different Icons#

PreviewCode

Value Text#

Use ClipboardValue component to display the value as text instead of an input field.

PreviewCode

https://x.com/vinihvc

Custom Timeout#

Use the timeout prop on Clipboard to customize how long the copied state is shown.

PreviewCode

API Reference#

Clipboard#

Root wrapper. Manages copy state and value.

PropTypeDefault
valuestringrequired
timeoutnumber2000
classNamestring-

ClipboardTrigger#

Triggers copy to clipboard on click.

PropTypeDefault
classNamestring-
asChildbooleanfalse

ClipboardInput#

Input showing the value to copy. Often hidden or read-only.

PropTypeDefault
classNamestring-
asChildbooleanfalse

ClipboardIndicator#

Icon that changes based on copy state.

PropTypeDefault
copiedReactNodeCheckIcon
classNamestring-

ClipboardValue#

Text display of the value. Use when input is not needed.

PropTypeDefault
size`"xs""sm"
classNamestring-
asChildbooleanfalse

For a complete list of props, see the Ark UI documentation.

[

Previous page

Circular Slider ](/docs/components/circular-slider)[

Next page

Collapsible ](/docs/components/collapsible)

On This Page

InstallationAnatomyUsageControlledExamplesIcon OnlyDifferent IconsValue TextCustom TimeoutAPI ReferenceClipboardClipboardTriggerClipboardInputClipboardIndicatorClipboardValue