mehdi-copy-to-clipboard

یک utility کوچک و سبک برای کپی کردن متن به کلیپ‌بورد مرورگر. این پکیج بدون هیچ وابستگی اضافی کار می‌کند و با TypeScript و JavaScript سازگار است.

📦 نصب

با npm:

npm install mehdi-copy-to-clipboard

با Yarn:

yarn add mehdi-copy-to-clipboard

⚡ ویژگی‌ها

• سبک و بدون dependency
• پشتیبانی کامل از TypeScript و JavaScript
• Promise-based (می‌توانی نتیجه عملیات را بررسی کنی)
• بسیار ساده برای استفاده در پروژه‌های وب و Next.js

🚀 استفاده

TypeScript

import { copyToClipboard } from 'mehdi-copy-to-clipboard';

function handleClick() {
  copyToClipboard("Hello world!", () => {
    showToast("متن با موفقیت کپی شد!");
  });
}

📝 API

copyToClipboard(text: string)

| پارامتر | نوع | توضیح | | ------- | -------- | ------------------------------------ | | text | string | متنی که می‌خوای در کلیپ‌بورد کپی شود |

🔧 نکات استفاده

1. برای کارکرد صحیح در مرورگر، باید صفحه روی HTTPS باشد یا localhost.
2. در محیط‌های سرور (Node.js بدون مرورگر) این utility کار نمی‌کند.
3. کاملاً بدون وابستگی خارجی است، حجم بسیار کم (~1.5 KB).

📖 مثال پیشرفته

import { copyToClipboard } from 'mehdi-copy-to-clipboard';
import { useState } from 'react';

export default function CopyButton() {

  const handleClick =  () => {
    copyToClipboard("Hello world!", () => {
    showToast("متن با موفقیت کپی شد!");
  });
  };

  return (
    <div>
      <button onClick={handleClick}>Copy</button>
    </div>
  );
}

📂 سازگاری

| محیط | پشتیبانی | | ---------------- | -------- | | مرورگر مدرن | ✅ | | TypeScript | ✅ |

🔗 منابع

• MDN Clipboard API
• npm: mehdi-copy-to-clipboard