xxf_react 0.3.8 → 0.4.0

package/dist/layout/image/XImage.d.ts

@@ -0,0 +1,17 @@
+import { ImageProps } from "next/image";
+import React, { ReactNode } from "react";
+export interface XImageProps extends ImageProps {
+    /** 图片加载失败时显示的备用图片 URL 或自定义组件 */
+    fallback?: string | ReactNode;
+}
+/**
+ * 增强的 Image 组件，支持加载失败时显示备用图片或自定义组件
+ * @param src - 图片地址
+ * @param fallback - 加载失败时显示的备用图片 URL 或 ReactNode
+ * @param onError - 加载失败回调
+ * @param className - 样式类名
+ * @param props - 其他 Next.js Image 支持的属性
+ */
+export declare function XImage({ src, fallback, onError, ...props }: XImageProps): React.JSX.Element;
+export default XImage;
+//# sourceMappingURL=XImage.d.ts.map

package/dist/layout/image/XImage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"XImage.d.ts","sourceRoot":"","sources":["../../../src/layout/image/XImage.tsx"],"names":[],"mappings":"AAEA,OAAc,EAAC,UAAU,EAAC,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EAAE,EAAsB,SAAS,EAAC,MAAM,OAAO,CAAC;AAE5D,MAAM,WAAW,WAAY,SAAQ,UAAU;IAC3C,gCAAgC;IAChC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACjC;AAED;;;;;;;GAOG;AACH,wBAAgB,MAAM,CAAC,EACI,GAAG,EACH,QAAQ,EACR,OAAO,EACP,GAAG,KAAK,EACX,EAAE,WAAW,qBAkDpC;AAED,eAAe,MAAM,CAAC"}

package/dist/layout/image/XImage.js

@@ -0,0 +1,45 @@
+"use client";
+import Image from "next/image";
+import React, { useState, useEffect } from "react";
+/**
+ * 增强的 Image 组件，支持加载失败时显示备用图片或自定义组件
+ * @param src - 图片地址
+ * @param fallback - 加载失败时显示的备用图片 URL 或 ReactNode
+ * @param onError - 加载失败回调
+ * @param className - 样式类名
+ * @param props - 其他 Next.js Image 支持的属性
+ */
+export function XImage({ src, fallback, onError, ...props }) {
+    const [imgSrc, setImgSrc] = useState(src);
+    const [hasError, setHasError] = useState(false);
+    // src 变化时重置状态
+    useEffect(() => {
+        setImgSrc(src);
+        setHasError(false);
+    }, [src]);
+    const handleError = (e) => {
+        if (fallback && !hasError) {
+            setHasError(true);
+            // 如果 fallback 是字符串（URL），则切换图片源
+            if (typeof fallback === "string") {
+                setImgSrc(fallback);
+                return; // fallback 切换时不触发 onError，等 fallback 也失败再触发
+            }
+        }
+        onError === null || onError === void 0 ? void 0 : onError(e);
+    };
+    // fallback 是 ReactNode 且已出错，用容器包裹并应用样式属性
+    if (hasError && fallback && typeof fallback !== "string") {
+        const width = typeof props.width === "number" ? props.width : props.width ? Number(props.width) : undefined;
+        const height = typeof props.height === "number" ? props.height : props.height ? Number(props.height) : undefined;
+        return (React.createElement("div", { className: props.className, style: {
+                width,
+                height,
+                position: props.fill ? "absolute" : undefined,
+                inset: props.fill ? 0 : undefined,
+                ...props.style,
+            } }, fallback));
+    }
+    return (React.createElement(Image, { ...props, src: imgSrc, onError: handleError }));
+}
+export default XImage;

package/dist/layout/index.d.ts

@@ -3,4 +3,5 @@ export * from './resize/core/SizedLayoutContext';
 export * from './resize/core/ResizeObserverHook';
 export * from './resize/impl/SizedContainer';
 export * from './resize/impl/SizedLayout';
+export * from './image/XImage';
 //# sourceMappingURL=index.d.ts.map

package/dist/layout/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/layout/index.ts"],"names":[],"mappings":"AAAA,cAAc,gCAAgC,CAAA;AAC9C,cAAc,kCAAkC,CAAA;AAChD,cAAc,kCAAkC,CAAA;AAChD,cAAc,8BAA8B,CAAA;AAC5C,cAAc,2BAA2B,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/layout/index.ts"],"names":[],"mappings":"AAAA,cAAc,gCAAgC,CAAA;AAC9C,cAAc,kCAAkC,CAAA;AAChD,cAAc,kCAAkC,CAAA;AAChD,cAAc,8BAA8B,CAAA;AAC5C,cAAc,2BAA2B,CAAA;AACzC,cAAc,gBAAgB,CAAA"}

package/dist/layout/index.js

@@ -3,3 +3,4 @@ export * from './resize/core/SizedLayoutContext';
 export * from './resize/core/ResizeObserverHook';
 export * from './resize/impl/SizedContainer';
 export * from './resize/impl/SizedLayout';
+export * from './image/XImage';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "xxf_react",
-  "version": "0.3.8",
+  "version": "0.4.0",
   "private": false,
   "type": "module",
   "main": "dist/index.js",
@@ -74,5 +74,8 @@
     "tailwind-variants": "^3.2.2",
     "tiny-lru": "^11.4.7",
     "use-debounce": "^10.0.6"
+  },
+  "devDependencies": {
+    "next": "^16.0.7"
   }
 }