رفتن به محتوای اصلی

کامپوننت‌ها

دکمهٔ کپی

کپی متن در کلیپ‌بورد با بازخورد «کپی شد»، برای کلید API، شماره شبا یا کد تخفیف.

import { CopyButton } from "@kashi-ui/react";

نمونه

<Input aria-label="کلید API" readOnly value="sk_live_4f9a…b21c" />
<CopyButton value={apiKey} />
<CopyButton value={iban} iconOnly labels={{ copy: "کپی شماره شبا" }} />
نامنوعپیش‌فرضتوضیح
valuestring—متنی که کپی می‌شود
onCopy(value: string) => void—پس از کپی موفق
iconOnlybooleanfalseفقط آیکون؛ نام از labels.copy
timeoutnumber2000مدت نمایش «کپی شد» به میلی‌ثانیه
labels{ copy?, copied?, failed? }«کپی»، «کپی شد»، «کپی نشد»
variant / sizeButtonProps"secondary" / "sm"همهٔ props دکمه

دسترس‌پذیری

نتیجه («کپی شد» یا «کپی نشد») با aria-live اعلام می‌شود، پس کاربر صفحه‌خوان هم بازخورد می‌گیرد. در حالت فقط‌آیکون، نام دکمه هم به «کپی شد» تغییر می‌کند. کلیپ‌بورد فقط در HTTPS یا localhost در دسترس است.