Copy button
Button
Primary actions are a solid fill in the accent token, secondary is an outline, tertiary is plain text. No glow, no gradient, no ghost primary. Grouped actions share one border.
실제로 돌아가는 부품입니다. 눌러 보고 입력해 보세요.
내 앱에 넣기
아직 npm 패키지가 없어서 Taster 리포를 받아 그 안의 명령을 씁니다. 내 앱 폴더가 들어 있는 폴더에서 한 번만 받습니다.
git clone https://github.com/makim-414/taster.git && npm ci --prefix taster/packages/engine내 앱 폴더에서 이 부품을 넣습니다. 부품 파일과 토큰 파일이
src/components/taster에 들어갑니다.node ../taster/packages/engine/cli.mjs add blocks/copy-button --from https://taster-six.vercel.app --dir src/components/taster부품은 Tailwind 클래스로 그리고, Taster 프리셋이 그 클래스를 토큰에 연결합니다. Tailwind CSS 를 설치하고,
tokens.css를 앱 루트에서 한 번 불러온 뒤, 앱 루트에 이 설정을 둡니다. 프리셋이 없으면 빌드는 되어도 부품이 스타일 없이 나옵니다.// tailwind.config.cjs module.exports = { presets: [require('./src/components/taster/tailwind-preset.cjs')], content: ['./index.html', './src/**/*.{ts,tsx}'], };Tailwind v3 는 이 파일을 그대로 읽습니다. v4 는 Tailwind 를 불러오는
src/의 스타일시트 맨 위에 이 두 줄을 넣습니다.@import "tailwindcss"; @config "../tailwind.config.cjs";tokens.css는:root에--bg,--text,--border,--accent를 정의합니다. 내 앱의 스타일시트가 같은 이름을 뒤에서 다시 정의하면 그쪽 색이 이깁니다. 새 Vite 앱의 스타터 CSS 처럼 그런 변수가 있으면 지우거나 이름을 바꾸세요.
언제 쓰나요
- Flat solid buttonPrimary actions are a solid fill in the accent token, secondary is an outline, tertiary is plain text. No glow, no gradient, no ghost primary. Grouped actions share one border.
대신 없애 주는 AI 티
- Ghost button as the main call to action (AC-16)
- Purple gradient (COL-01)
- Large colored glow shadow (COL-07)
- Touch target under 44px (RSP-06)
정보
코드 보기
'use client'
import * as React from 'react'
import { cn } from './_cn'
// CopyButton. Copies a value to the clipboard and says so: the label turns to "Copied" for two seconds and the
// result is announced politely. Falls back to a hidden text area where the Clipboard API is not available, and
// says "Copy failed" instead of pretending. The button keeps its width while the label changes.
export interface CopyButtonProps extends Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, 'onClick' | 'children' | 'value'> {
value: string
label?: string
copiedLabel?: string
failedLabel?: string
/** How long the confirmation stays, in ms. */
timeout?: number
onCopied?: (value: string) => void
variant?: 'outline' | 'ghost'
}
async function writeText(text: string): Promise<boolean> {
try {
if (navigator.clipboard && window.isSecureContext) {
await navigator.clipboard.writeText(text)
return true
}
} catch {
// fall through to the text area fallback
}
try {
const ta = document.createElement('textarea')
ta.value = text
ta.setAttribute('readonly', '')
ta.style.position = 'fixed'
ta.style.opacity = '0'
document.body.appendChild(ta)
ta.select()
const ok = document.execCommand('copy')
ta.remove()
return ok
} catch {
return false
}
}
export const CopyButton = React.forwardRef<HTMLButtonElement, CopyButtonProps>(
(
{ value, label = 'Copy', copiedLabel = 'Copied', failedLabel = 'Copy failed', timeout = 2000, onCopied, variant = 'outline', className, ...props },
ref,
) => {
const [state, setState] = React.useState<'idle' | 'copied' | 'failed'>('idle')
const timer = React.useRef<number>()
React.useEffect(() => () => window.clearTimeout(timer.current), [])
const text = state === 'copied' ? copiedLabel : state === 'failed' ? failedLabel : label
return (
<>
<button
ref={ref}
type="button"
onClick={async () => {
const ok = await writeText(value)
setState(ok ? 'copied' : 'failed')
if (ok) onCopied?.(value)
window.clearTimeout(timer.current)
timer.current = window.setTimeout(() => setState('idle'), timeout)
}}
className={cn(
'inline-grid h-11 items-center rounded-md px-3 text-sm font-medium text-text outline-none desk:h-9',
'transition-[colors,transform] duration-press ease-out active:scale-press',
'focus-visible:ring-2 focus-visible:ring-ring disabled:pointer-events-none disabled:opacity-50',
variant === 'outline' ? 'border border-border hover:border-text-subtle' : 'hover:bg-bg-elev',
className,
)}
{...props}
>
{/* Every label is laid in the same grid cell, so the widest one sets the width. */}
{[label, copiedLabel, failedLabel].map((l) => (
<span
key={l}
aria-hidden={l !== text}
className={cn('col-start-1 row-start-1 inline-flex items-center justify-center gap-1.5', l === text ? 'visible' : 'invisible')}
>
{l === copiedLabel && (
<svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth={1.75} strokeLinecap="round" strokeLinejoin="round" aria-hidden="true">
<path d="M5 13l4 4 10-10" />
</svg>
)}
{l}
</span>
))}
</button>
<span className="sr-only" role="status" aria-live="polite">
{state === 'copied' ? copiedLabel : state === 'failed' ? failedLabel : ''}
</span>
</>
)
},
)
CopyButton.displayName = 'CopyButton'