データとフィードバック@neumorphism-ui/image-card

Image Card

標準の img と figure/figcaption の意味を保ったまま、画像と説明をニューモーフィズム surface にまとめます。画像の読み込みや最適化はアプリやフレームワーク側が担当します。

@neumorphism-ui/image-card
Registry JSON

プレビュー

柔らかな青いグラデーションのワークスペースカバー
Design system workspace · 12 components

インストール

インストール: image-cardnpx shadcn@latest add @neumorphism-ui/image-card

CLI が 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 リファレンス

コンポーネントプロパティ型デフォルト説明
ImageCardsrc必須string—表示する画像 URL です。
ImageCardalt必須string—画像の目的を説明する代替テキストです。
ImageCardcaptionReactNode—任意の figcaption コンテンツです。
ImageCardimageClassNamestring—既定の aspect と object-fit スタイルを拡張します。
ImageCardfigure propsReact.ComponentProps<"figure">—figure に標準 HTML 属性を渡します。

アクセシビリティ

  • 01

    情報を伝える画像には意味のある alt を、装飾画像には空の alt を使用します。

  • 02

    caption は画像に関連する説明に使い、無関係な操作やナビゲーションの代替にしません。

  • 03

    画像最適化が必要なフレームワークでは、インストール後の source を編集して画像コンポーネントを置き換えられます。