Files
Arkie-Library-Frontend/src/components/messageStream/BubbleImage.tsx
TerryM 0035457c6d feat: 媒体流图片自适应显示(单图/2图/Telegram式相册)
- 单图气泡按真实比例显示:横图限高260px、过高裁上下;竖图完整铺满宽度不裁、无黑边
- 2张同类相册:都竖图左右并排、都横图上下堆叠,按比例不裁
- 3+张相册:Telegram式马赛克拼贴(竖主图占左+其余堆右 / 横主图占顶+其余排底)
- 图片比例优先用后端width/height,缺失时从加载后的naturalWidth/Height读取
- 新增 constants/media.ts 统一尺寸规范;albumLayout 纯算法附单测

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-05-29 22:16:55 +08:00

81 lines
2.3 KiB
TypeScript

import { ImageOff } from "lucide-react";
import { useEffect, useMemo, useState } from "react";
type BubbleImageProps = {
src: string | undefined;
/**
* Optional absolute URL(s) to try if `src` fails to load. Useful when `src`
* is an optimized-but-fragile thumbnail (e.g. a root-relative thumbnailUrl)
* and we want to fall back to the reliable full-size asset before giving up.
*/
fallbackSrc?: string | (string | undefined)[];
className?: string;
loading?: "lazy" | "eager";
/**
* Called once the active source loads, with the image's intrinsic pixel
* size. Lets callers (e.g. single-image bubbles) adopt the real aspect
* ratio without depending on backend-provided width/height.
*/
onNaturalSize?: (width: number, height: number) => void;
};
/**
* Thumbnail <img> for message bubbles. Renders with an empty alt (decorative)
* and, if every candidate source fails to load, falls back to a neutral
* placeholder instead of the browser's broken-image box — which would otherwise
* expose the raw file name via alt text.
*/
export function BubbleImage({
src,
fallbackSrc,
className,
loading,
onNaturalSize,
}: BubbleImageProps) {
// Ordered, de-duplicated list of sources to attempt in turn.
const candidates = useMemo(() => {
const extra = Array.isArray(fallbackSrc) ? fallbackSrc : [fallbackSrc];
return [src, ...extra].filter(
(value, index, all): value is string =>
!!value && all.indexOf(value) === index,
);
}, [src, fallbackSrc]);
const [attempt, setAttempt] = useState(0);
// Reset when the candidate set changes so a reused element re-attempts.
useEffect(() => {
setAttempt(0);
}, [candidates]);
const current = candidates[attempt];
if (!current) {
return (
<div
className={`flex items-center justify-center bg-gradient-to-br from-neutral-800 to-neutral-900 ${
className ?? ""
}`}
aria-hidden
>
<ImageOff className="h-8 w-8 text-neutral-600" />
</div>
);
}
return (
<img
src={current}
alt=""
loading={loading}
className={className}
onLoad={(e) => {
const img = e.currentTarget;
if (img.naturalWidth && img.naturalHeight)
onNaturalSize?.(img.naturalWidth, img.naturalHeight);
}}
onError={() => setAttempt((i) => i + 1)}
/>
);
}