데이터와 피드백@neumorphism-ui/image-card

Image Card

표준 img와 figure/figcaption 의미를 유지하면서 이미지와 설명을 뉴모피즘 surface로 묶습니다. 이미지 로딩·최적화는 애플리케이션이나 프레임워크가 소유하고, 이 컴포넌트는 콘텐츠 구조와 표면만 제공합니다.

@neumorphism-ui/image-card
Registry JSON

미리보기

부드러운 파란 그라데이션의 워크스페이스 표지
디자인 시스템 워크스페이스 · 12 components

설치

설치: image-cardnpx shadcn@latest add @neumorphism-ui/image-card

CLI가 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 레퍼런스

컴포넌트속성타입기본값설명
ImageCardsrc필수string—표시할 이미지 URL입니다.
ImageCardalt필수string—이미지의 목적을 설명하는 대체 텍스트입니다.
ImageCardcaptionReactNode—선택적인 figcaption 콘텐츠입니다.
ImageCardimageClassNamestring—기본 aspect와 object-fit 스타일을 확장합니다.
ImageCardfigure propsReact.ComponentProps<"figure">—figure에 표준 HTML 속성을 전달합니다.

접근성

  • 01

    정보를 전달하는 이미지에는 내용을 설명하는 alt를 제공하고 장식 이미지는 빈 alt를 사용합니다.

  • 02

    caption은 이미지와 관련된 설명에 사용하고 별개의 조작 버튼이나 내비게이션을 대신하지 않습니다.

  • 03

    이미지 최적화 컴포넌트가 필요한 프레임워크에서는 source를 직접 수정해 해당 이미지 컴포넌트로 교체할 수 있습니다.