Image Card
표준 img와 figure/figcaption 의미를 유지하면서 이미지와 설명을 뉴모피즘 surface로 묶습니다. 이미지 로딩·최적화는 애플리케이션이나 프레임워크가 소유하고, 이 컴포넌트는 콘텐츠 구조와 표면만 제공합니다.
@neumorphism-ui/image-card미리보기
설치
설치: image-card
npx shadcn@latest add @neumorphism-ui/image-cardCLI가 npm 의존성, base 토큰, utils와 컴포넌트 소스를 순서대로 확인하고 설치합니다.
Registry를 처음 사용한다면 namespace 설정 을 먼저 완료하세요.
사용법
Import
Image Card import 코드
import { ImageCard } from "@/components/ui/image-card";Example
Image Card 사용 코드
export default function Example() {
return <ImageCard src="/workspace-cover.jpg" alt="부드러운 파란 그라데이션의 워크스페이스 표지" caption="Design system workspace · 12 components" />;
}API 레퍼런스
| 컴포넌트 | 속성 | 타입 | 기본값 | 설명 |
|---|---|---|---|---|
ImageCard | src필수 | string | — | 표시할 이미지 URL입니다. |
ImageCard | alt필수 | string | — | 이미지의 목적을 설명하는 대체 텍스트입니다. |
ImageCard | caption | ReactNode | — | 선택적인 figcaption 콘텐츠입니다. |
ImageCard | imageClassName | string | — | 기본 aspect와 object-fit 스타일을 확장합니다. |
ImageCard | figure props | React.ComponentProps<"figure"> | — | figure에 표준 HTML 속성을 전달합니다. |
접근성
- 01
정보를 전달하는 이미지에는 내용을 설명하는 alt를 제공하고 장식 이미지는 빈 alt를 사용합니다.
- 02
caption은 이미지와 관련된 설명에 사용하고 별개의 조작 버튼이나 내비게이션을 대신하지 않습니다.
- 03
이미지 최적화 컴포넌트가 필요한 프레임워크에서는 source를 직접 수정해 해당 이미지 컴포넌트로 교체할 수 있습니다.