@d-matrix/utils 1.6.0 → 1.7.0

package/dist/date.d.ts

@@ -6,3 +6,15 @@
  * @return {number[]} an array of numbers representing the range of years
  */
 export declare const rangeOfYears: (start: number, end?: number) => number[];
+export interface RecentYearOption {
+    label: string;
+    value: number;
+}
+/**
+ * 获取最近n年, 从大到小
+ * @param recentYears 最近几年
+ * @param type 控制返回值类型
+ * @param suffix 后缀，默认为'年'
+ */
+export declare function getRecentYears(recentYears: number, type: 'number[]'): number[];
+export declare function getRecentYears(recentYears: number, type: 'object[]'): RecentYearOption[];

package/dist/date.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.rangeOfYears = void 0;
+exports.getRecentYears = exports.rangeOfYears = void 0;
 /**
  * Generates an array of numbers representing a range of years between the start year and the end year.
  *
@@ -15,3 +15,26 @@ var rangeOfYears = function (start, end) {
         .map(function (year, index) { return year + index; });
 };
 exports.rangeOfYears = rangeOfYears;
+function getRecentYears(recentYears, type, suffix) {
+    if (suffix === void 0) { suffix = '年'; }
+    var thisYear = new Date().getFullYear();
+    if (type === 'number[]') {
+        var result = [];
+        for (var i = 0; i < recentYears; i++) {
+            result.push(thisYear - i);
+        }
+        return result;
+    }
+    if (type === 'object[]') {
+        var result = [];
+        for (var i = 0; i < recentYears; i++) {
+            result.push({
+                value: thisYear - i,
+                label: "" + (thisYear - i) + suffix,
+            });
+        }
+        return result;
+    }
+    throw new Error('type must be "number[]" or "object[]"');
+}
+exports.getRecentYears = getRecentYears;

package/dist/dom.d.ts

@@ -2,3 +2,10 @@
  * 元素滚动条滚动到顶部
  */
 export declare function scrollToTop(element: Element | null | undefined): void;
+/**
+ * Strips HTML tags from a given string and returns the plain text content.
+ *
+ * @param {string} html - The HTML string to strip tags from.
+ * @return {string} The plain text content of the HTML string.
+ */
+export declare function strip(html: string): string;

package/dist/dom.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.scrollToTop = void 0;
+exports.strip = exports.scrollToTop = void 0;
 /**
  * 元素滚动条滚动到顶部
  */
@@ -19,3 +19,14 @@ function scrollToTop(element) {
     }
 }
 exports.scrollToTop = scrollToTop;
+/**
+ * Strips HTML tags from a given string and returns the plain text content.
+ *
+ * @param {string} html - The HTML string to strip tags from.
+ * @return {string} The plain text content of the HTML string.
+ */
+function strip(html) {
+    var doc = new DOMParser().parseFromString(html !== null && html !== void 0 ? html : '', 'text/html');
+    return doc.body.textContent || '';
+}
+exports.strip = strip;

package/dist/react/useCopyToClipboard.js

@@ -42,7 +42,7 @@ function useCopyToClipboard(props) {
             }, timeout);
         })
             .catch(function (error) { return onError === null || onError === void 0 ? void 0 : onError(error); });
-    }, []);
+    }, [onCopy, onError, timeout]);
     return { isCopied: isCopied, copyToClipboard: copyToClipboard };
 }
 exports.useCopyToClipboard = useCopyToClipboard;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@d-matrix/utils",
-  "version": "1.6.0",
+  "version": "1.7.0",
   "description": "A dozen of utils for Front-End Development",
   "main": "dist/index.js",
   "scripts": {

package/readme.md

@@ -86,7 +86,7 @@ const Test = () => {
 
 - `useCopyToClipboard(props?: UseCopyToClipboardProps)`
 
-复制文本到剪切板, 用法见[测试]('./tests/react.cy.tsx)
+复制文本到剪切板, 用法见[测试](./tests/react.cy.tsx)
 
 ### dom
 
@@ -94,12 +94,46 @@ const Test = () => {
 
 元素滚动条滚动到顶部，对老旧浏览器做了兼容，见[浏览器兼容性](https://developer.mozilla.org/en-US/docs/Web/API/Element/scrollTop#browser_compatibility)。
 
+- `strip(html: string): string`
+
+从字符串中去除 HTML 标签并返回纯文本内容。
+
+```ts
+import { dom } from '@d-matrix/utils';
+
+dom.strip('测试<em>高亮</em>测试'); // '测试高亮测试'
+```
+
 ### date
 
 - `rangeOfYears(start: number, end: number = new Date().getFullYear()): number[]`
 
 创建`start`和`end`之间的年份数组。
 
+- `getRecentYears()`
+
+```ts
+export function getRecentYears(recentYears: number, type: 'number[]'): number[];
+export function getRecentYears(recentYears: number, type: 'object[]'): RecentYearOption[];
+export function getRecentYears(recentYears: number, type: 'number[]' | 'object[]', suffix = '年'): number[] | RecentYearOption[]
+```
+
+获取最近n年
+
+```ts
+import { date } from '@d-matrix/utils';
+
+getRecentYears(5, 'number[]'); // [2024, 2023, 2022, 2021, 2020]
+getRecentYears(5, 'object[]');
+// [
+//   { value: 2024, label: '2024年' },
+//   { value: 2023, label: '2023年' },
+//   { value: 2022, label: '2022年' },
+//   { value: 2021, label: '2021年' },
+//   { value: 2020, label: '2020年' },
+// ]
+```
+
 ### types
 
 - `WithOptional<T, K extends keyof T>`