Files
readest/apps/readest-app/src/components/BookCover.tsx
T
Huang Xin 7b60b1bb0c fix(ios): reduce GPU memory pressure to prevent WebKit GPU process crash (#3842)
On iOS, navigating to a book group in the library caused the WebKit GPU
process to exceed its 300 MB jetsam limit (peaking at ~328 MB), resulting
in a blank screen flash and broken scroll state.

Three changes reduce peak GPU memory usage:

- Add overscan={200} to VirtuosoGrid/Virtuoso so only items within 200px
  of the viewport are rendered, limiting simultaneous image decoding
- Add loading="lazy" to both Image components in BookCover so the browser
  defers decoding offscreen cover images
- Conditionally mount the <video> and <audio> elements in AtmosphereOverlay
  only when atmosphere mode is active, eliminating idle H.264 decoder
  memory overhead

Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-12 09:06:16 +02:00

166 lines
5.2 KiB
TypeScript

import clsx from 'clsx';
import Image from 'next/image';
import { memo, useEffect, useRef, useState } from 'react';
import { Book } from '@/types/book';
import { LibraryCoverFitType, LibraryViewModeType } from '@/types/settings';
import { formatAuthors, formatTitle } from '@/utils/book';
interface BookCoverProps {
book: Book;
mode?: LibraryViewModeType;
coverFit?: LibraryCoverFitType;
className?: string;
imageClassName?: string;
showSpine?: boolean;
isPreview?: boolean;
onImageError?: () => void;
}
const BookCover: React.FC<BookCoverProps> = memo<BookCoverProps>(
({
book,
mode = 'grid',
coverFit = 'crop',
showSpine = false,
className,
imageClassName,
isPreview,
onImageError,
}) => {
const coverRef = useRef<HTMLDivElement>(null);
const [imageLoaded, setImageLoaded] = useState(false);
const [imageError, setImageError] = useState(false);
const shouldShowSpine = showSpine && imageLoaded && !imageError;
const toggleImageVisibility = (showImage: boolean) => {
if (coverRef.current) {
const coverImage = coverRef.current.querySelector('.cover-image');
const fallbackCover = coverRef.current.querySelector('.fallback-cover');
if (coverImage) {
coverImage.classList.toggle('invisible', !showImage);
}
if (fallbackCover) {
fallbackCover.classList.toggle('invisible', showImage);
}
}
};
const handleImageLoad = () => {
setImageLoaded(true);
setImageError(false);
toggleImageVisibility(true);
};
const handleImageError = () => {
setImageLoaded(false);
setImageError(true);
toggleImageVisibility(false);
onImageError?.();
};
useEffect(() => {
toggleImageVisibility(true);
}, [book.metadata?.coverImageUrl, book.coverImageUrl]);
return (
<div
ref={coverRef}
className={clsx('book-cover-container relative flex h-full w-full', className)}
>
{coverFit === 'crop' ? (
<>
<Image
src={book.metadata?.coverImageUrl || book.coverImageUrl!}
alt={book.title}
fill={true}
loading='lazy'
className={clsx('cover-image crop-cover-img object-cover', imageClassName)}
onLoad={handleImageLoad}
onError={handleImageError}
/>
<div
className={`book-spine absolute inset-0 ${shouldShowSpine ? 'visible' : 'invisible'}`}
/>
</>
) : (
<div className={clsx('flex h-full w-full justify-start')}>
<div
className={clsx(
'flex h-full max-h-full items-end',
mode === 'grid' ? 'items-end' : 'items-center',
)}
>
<Image
src={book.metadata?.coverImageUrl || book.coverImageUrl!}
alt={book.title}
width={0}
height={0}
sizes='100vw'
loading='lazy'
className={clsx(
'cover-image fit-cover-img h-auto max-h-full w-auto max-w-full shadow-md',
imageClassName,
)}
onLoad={handleImageLoad}
onError={handleImageError}
/>
<div
className={`book-spine absolute inset-0 ${shouldShowSpine ? 'visible' : 'invisible'}`}
/>
</div>
</div>
)}
<div
className={clsx(
'fallback-cover invisible absolute inset-0 p-2',
'text-neutral-content text-center font-serif font-medium',
isPreview ? 'bg-base-200/50' : 'bg-base-100',
imageClassName,
)}
>
<div className='flex h-1/2 items-center justify-center'>
<span
className={clsx(
isPreview ? 'line-clamp-2' : mode === 'grid' ? 'line-clamp-3' : 'line-clamp-2',
isPreview ? 'text-[0.5em]' : mode === 'grid' ? 'text-lg' : 'text-sm',
)}
>
{formatTitle(book.title)}
</span>
</div>
<div className='h-1/6'></div>
<div className='flex h-1/3 items-center justify-center'>
<span
className={clsx(
'text-neutral-content/50 line-clamp-1',
isPreview ? 'text-[0.4em]' : mode === 'grid' ? 'text-base' : 'text-xs',
)}
>
{formatAuthors(book.author)}
</span>
</div>
</div>
</div>
);
},
(prevProps, nextProps) => {
return (
prevProps.book.coverImageUrl === nextProps.book.coverImageUrl &&
prevProps.book.metadata?.coverImageUrl === nextProps.book.metadata?.coverImageUrl &&
prevProps.book.updatedAt === nextProps.book.updatedAt &&
prevProps.mode === nextProps.mode &&
prevProps.coverFit === nextProps.coverFit &&
prevProps.isPreview === nextProps.isPreview &&
prevProps.showSpine === nextProps.showSpine &&
prevProps.className === nextProps.className &&
prevProps.imageClassName === nextProps.imageClassName
);
},
);
BookCover.displayName = 'BookCover';
export default BookCover;