@d-matrix/utils 1.11.0 → 1.12.1

package/dist/clipboard.d.ts

@@ -1 +1,12 @@
+/**
+ * 复制图片到剪贴板
+ * @param element
+ * @returns
+ */
 export declare function writeImage(element: HTMLImageElement | null | string): Promise<unknown>;
+/**
+ * 复制文本到剪贴板
+ * @param text
+ * @returns
+ */
+export declare function writeText(text: string): Promise<void>;

package/dist/clipboard.js

@@ -7,6 +7,11 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
+/**
+ * 复制图片到剪贴板
+ * @param element
+ * @returns
+ */
 export function writeImage(element) {
     return __awaiter(this, void 0, void 0, function* () {
         return new Promise((resolve, reject) => {
@@ -58,3 +63,45 @@ export function writeImage(element) {
         });
     });
 }
+const legacyWriteText = (text) => {
+    const $textarea = document.createElement('textarea');
+    $textarea.value = text;
+    $textarea.id = '__textarea_for_clipboard__';
+    $textarea.style.cssText = 'position: fixed; width: 20px; height: 20px; opacity: 0; top: -20px;';
+    document.body.appendChild($textarea);
+    $textarea.select();
+    try {
+        const isSuccess = document.execCommand('copy');
+        if (!isSuccess && process.env.NODE_ENV === 'development') {
+            console.error('复制文本失败, 操作不被支持或未被启用');
+        }
+    }
+    catch (error) {
+        if (process.env.NODE_ENV === 'development') {
+            console.error('复制文本失败', error);
+        }
+        throw error;
+    }
+    finally {
+        document.body.removeChild($textarea);
+    }
+};
+/**
+ * 复制文本到剪贴板
+ * @param text
+ * @returns
+ */
+export function writeText(text) {
+    return __awaiter(this, void 0, void 0, function* () {
+        if (!navigator.clipboard) {
+            legacyWriteText(text);
+            return;
+        }
+        return navigator.clipboard.writeText(text).catch((error) => {
+            if (process.env.NODE_ENV === 'development') {
+                console.error('复制文本失败', error);
+            }
+            return Promise.reject(error);
+        });
+    });
+}

package/package.json

@@ -1,18 +1,20 @@
 {
   "name": "@d-matrix/utils",
   "sideEffects": false,
-  "version": "1.11.0",
+  "version": "1.12.1",
   "description": "A dozen of utils for Front-End Development",
   "main": "dist/index.js",
   "scripts": {
     "build": "tsc",
     "prebuild": "npm run clean",
+    "postpublish": "echo \"wait for 3 seconds, then sync cnpm\" && npm run wait3s && npm run cnpm:sync",
     "clean": "rimraf dist",
     "cy:open": "cypress open",
     "cy:component": "cypress run --component --spec",
     "cy:component:all": "cypress run --component",
     "test:tsd": "tsd",
     "postversion": "git push && git push --tags",
+    "wait3s": "node -e \"setTimeout(() => process.exit(0), 3000)\"",
     "cnpm:sync": "cnpm sync %npm_package_name%"
   },
   "engines": {

package/readme.md

@@ -20,9 +20,13 @@ A dozen of utils for Front-End Development
 
 ### clipboard
 
-- `clipboard.writeImage(element: HTMLImageElement | null | string): void`
+- `writeImage(element: HTMLImageElement | null | string): Promise<void>`
 
-复制图片到剪贴板。
+复制图片到剪贴板
+
+- `writeText(text: string): Promise<void>`
+
+复制文本到剪切板
 
 ### react
 
@@ -143,7 +147,7 @@ dom.strip('测试<em>高亮</em>测试'); // '测试高亮测试'
 
 创建`start`和`end`之间的年份数组。
 
-- `getRecentYears()`
+- `getYears()`
 
 ```ts
 export type GetRecentYearsOptions = {