Toast

作業を妨げず、操作結果を一時的に伝える場合に使います。

プレビュー

結果の通知と取り消し

ローカルの成功・エラー、下書き保管の取り消し、自動で閉じる通知を比較します。

プレビューを読み込んでいます。

インストール

この Registry を初めて使う場合は、先に 基本設定と共通スタイルの導入 を完了してください。

npx shadcn@latest add @neumorphism-ui/toast

共有 base を一度導入した後、CLI でコンポーネントと依存関係を追加します。

結果の通知と取り消し

npx shadcn@latest add @neumorphism-ui/button @neumorphism-ui/toast
Registry JSON

使い方

ToastProvider と Toaster を配置し、子の useToast で通知を追加します。読みやすいタイトルと、内容に合う表示時間や取り消し操作を指定します。

"use client";

import { Button } from "@/components/ui/button";
import { Toaster, ToastProvider, useToast } from "@/components/ui/toast";

function NotifyButton() {
  const toast = useToast();
  return <Button onClick={() => toast.add({ title: "Changes saved", type: "success" })}>Show notification</Button>;
}

export default function Example() {
  return <ToastProvider><NotifyButton /><Toaster /></ToastProvider>;
}

API リファレンス

既存のBase UI Toastで寿命とアクセシビリティを管理します。成功、エラー、取り消し、自動終了のローカル例で、サーバー保存は行いません。

コンポーネントプロパティ型デフォルト説明
ToastProvidertimeout / limit / toastManagernumber / ToastManager—表示時間、件数、外部マネージャーです。0で自動終了を無効にします。
useToastadd / close / update / promiseBase UI toast manager methods—通知を生成、終了、更新し、非同期状態を追跡します。
Toasterlabel / closeLabelstring—通知領域と閉じるボタンの名前です。

アクセシビリティ

  • 01

    F6で通知領域へ移動します。色だけでなく見出しと説明で結果を伝えてください。

  • 02

    重要な復旧操作は画面にも用意してください。例では確認用に手動終了を基本にしています。