@d-matrix/utils 1.25.0 → 1.26.0

package/dist/file.js

@@ -109,6 +109,8 @@ export function download(source, fileName = '', target) {
             link.target = target;
         }
         else {
+            // https://stackoverflow.com/questions/33909763/download-attribute-with-a-file-name-not-working
+            // download 只在同源 URL 或 blob:、data: 协议起作用, 如果下载不同源的oss文件，download属性无效
             link.download = fileName;
         }
         link.href = source;

package/dist/react/index.d.ts

@@ -9,3 +9,4 @@ export * from './types';
 export * from './useForwardRef';
 export * from './useIsomorphicLayoutEffect';
 export * from './useMediaQuery';
+export * from './useIsFirstRender';

package/dist/react/index.js

@@ -9,3 +9,4 @@ export * from './types';
 export * from './useForwardRef';
 export * from './useIsomorphicLayoutEffect';
 export * from './useMediaQuery';
+export * from './useIsFirstRender';

package/dist/react/useIsFirstRender.d.ts

@@ -0,0 +1,6 @@
+/**
+ * 使用 useIsFirstRender 区分第一次和后续渲染
+ * useIsFirstRender 对于确定当前渲染是否是组件的第一个渲染很有用。当你想在初始渲染时有条件地执行某些逻辑或渲染特定组件时，这个钩子特别有价值，提供了一种有效的方法来区分第一次和后续渲染。
+ * @returns boolean true 表示第一次渲染，false 表示其他渲染
+ */
+export declare function useIsFirstRender(): boolean;

package/dist/react/useIsFirstRender.js

@@ -0,0 +1,14 @@
+import { useRef } from 'react';
+/**
+ * 使用 useIsFirstRender 区分第一次和后续渲染
+ * useIsFirstRender 对于确定当前渲染是否是组件的第一个渲染很有用。当你想在初始渲染时有条件地执行某些逻辑或渲染特定组件时，这个钩子特别有价值，提供了一种有效的方法来区分第一次和后续渲染。
+ * @returns boolean true 表示第一次渲染，false 表示其他渲染
+ */
+export function useIsFirstRender() {
+    const renderRef = useRef(true);
+    if (renderRef.current === true) {
+        renderRef.current = false;
+        return true;
+    }
+    return renderRef.current;
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@d-matrix/utils",
   "sideEffects": false,
-  "version": "1.25.0",
+  "version": "1.26.0",
   "description": "A dozen of utils for Front-End Development",
   "main": "dist/index.js",
   "scripts": {

package/readme.md

@@ -198,6 +198,10 @@ export default function Component() {
 }
 ```
 
+- `useIsFirstRender(): boolean`
+
+对于确定当前渲染是否是组件的第一个渲染很有用。当你想在初始渲染时有条件地执行某些逻辑或渲染特定组件时，这个 hook 特别有价值，提供了一种有效的方法来区分第一次和后续渲染。
+
 ### dom
 
 - `scrollToTop(element: Element | null | undefined): void`