Image Card
이미지와 설명을 독립적인 콘텐츠 하나로 묶어 보여 줄 때 사용합니다.
미리보기
워크스페이스 표지
표지 이미지에 대체 텍스트와 짧은 디자인 시스템 설명을 연결합니다.
미리보기를 불러오는 중입니다.
설치
Registry를 처음 사용한다면 기본 설정과 공통 스타일 설치 을 먼저 완료하세요.
npx shadcn@latest add @neumorphism-ui/image-card공통 base를 한 번 설치한 뒤 CLI로 필요한 컴포넌트와 의존성을 추가합니다.
사용법
실제 이미지 주소와 의미 있는 alt를 제공하고 맥락이 필요하면 caption을 추가하세요. 이미지 전송과 최적화는 앱에서 관리합니다.
import { ImageCard } from "@/components/ui/image-card";
export default function Example() {
return <ImageCard src="/workspace.jpg" alt="A shared workspace" caption="Our design studio" />;
}API 레퍼런스
표준 img와 figure/figcaption 의미를 유지하면서 이미지와 설명을 뉴모피즘 surface로 묶습니다. 이미지 로딩·최적화는 애플리케이션이나 프레임워크가 소유하고, 이 컴포넌트는 콘텐츠 구조와 표면만 제공합니다.
| 컴포넌트 | 속성 | 타입 | 기본값 | 설명 |
|---|---|---|---|---|
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를 직접 수정해 해당 이미지 컴포넌트로 교체할 수 있습니다.