Image Card
標準の img と figure/figcaption の意味を保ったまま、画像と説明をニューモーフィズム surface にまとめます。画像の読み込みや最適化はアプリやフレームワーク側が担当します。
@neumorphism-ui/image-cardプレビュー
インストール
インストール: image-card
npx shadcn@latest add @neumorphism-ui/image-cardCLI が npm 依存関係、base token、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 を編集して画像コンポーネントを置き換えられます。