---
title: "Toast"
description: "Kısa süreli onay mesajı. Banner ile aynı durum renkleri: kartta ikon ve ince kenar, istenirse soft ton."
---

<Callout type="info" title="Ne zaman kullanılır">
Takip gerektirmeyen sonuçlar: "Kaydedildi", "Kopyalandı", "1.284 ürün eşitlendi". Mağaza sahibinin bir şey yapması gerekiyorsa Banner kullanın.
</Callout>

## Kurulum

```bash
npx shadcn@latest add @ikas/sonner
```

Registry tanımı yoksa önce [Kurulum](https://builders.ikas.com/tr/docs/app-development/ui-kit/installation) adımlarını tamamlayın.

## Örnekler

### Görünüm

Tetiklemeden, yalnızca toast'lar: popover kartı, durumu taşıyan ikon (rengi Banner ikonuyla aynı), warning ve error'da baştaki 3px'lik ince kenar, açıklama ve "Geri al" aksiyonu. Toaster `<html>` üzerindeki `dark` sınıfını izler; koyu temada ayrıca ayar gerekmez.

**Örnek: Görünüm** (`toast/preview`) · [Canlı önizleme](https://builders.ikas.com/ui-preview/demo/toast/preview)

```tsx
import * as React from "react"
import { toast } from "sonner"

import { Toaster } from "@/components/ui/sonner"

const TOASTER = "toast-preview"

/** Toasts on their own: a local Toaster pinned inside the frame, filled on mount. */
export default function ToastPreview() {
  React.useEffect(() => {
    // Fixed ids keep StrictMode's double effect from stacking duplicates.
    const options = { toasterId: TOASTER, duration: Infinity }
    toast.error("Kaydedilemedi", { ...options, id: "preview-error", description: "Bağlantı koptu. Değişiklikleriniz bu cihazda duruyor." })
    toast.warning("3 ürün atlandı", { ...options, id: "preview-warning", description: "Barkodu olmayan ürünler gönderilmedi." })
    toast.success("Kural silindi", {
      ...options,
      id: "preview-success",
      description: "Düşük stok uyarısı",
      action: { label: "Geri al", onClick: () => toast.dismiss("preview-success") },
    })
  }, [])

  return (
    <div className="relative mx-auto h-64 w-full max-w-[400px]">
      <Toaster id={TOASTER} expand position="bottom-center" offset={0} className="absolute! inset-0! w-full! transform-none!" />
    </div>
  )
}
```

### Türler

success, info, warning, error ve sade toast. Başarı ikonu çizilerek gelir.

**Örnek: Türler** (`toast/types`) · [Canlı önizleme](https://builders.ikas.com/ui-preview/demo/toast/types)

```tsx
import { toast } from "sonner"

import { Button } from "@/components/ui/button"

export default function ToastTypes() {
  return (
    <div className="flex flex-wrap items-center gap-2">
      <Button variant="outline" onClick={() => toast.success("Ayarlar kaydedildi")}>
        Başarılı
      </Button>
      <Button variant="outline" onClick={() => toast.info("Eşitleme sıraya alındı", { description: "Yaklaşık 2 dakika içinde başlar." })}>
        Bilgi
      </Button>
      <Button variant="outline" onClick={() => toast.warning("3 ürün atlandı", { description: "Barkodu olmayan ürünler gönderilmedi." })}>
        Uyarı
      </Button>
      <Button variant="outline" onClick={() => toast.error("Kaydedilemedi", { description: "Bağlantı koptu. Tekrar deneyin." })}>
        Hata
      </Button>
      <Button variant="ghost" onClick={() => toast("Bağlantı panoya kopyalandı")}>
        Sade
      </Button>
    </div>
  )
}
```

### Soft

`<Toaster variant="soft" />` her toast'ı soft Banner gibi durum tonuyla boyar; aksiyon butonu da tonu alır. Uygulama genelinde tek yerde seçin, toast başına değiştirmeyin.

**Örnek: Soft** (`toast/soft`) · [Canlı önizleme](https://builders.ikas.com/ui-preview/demo/toast/soft)

```tsx
import * as React from "react"
import { toast } from "sonner"

import { Toaster } from "@/components/ui/sonner"

const TOASTER = "toast-soft"

/** variant="soft": the Banner tint on every toast. For apps that want toasts to read louder. */
export default function ToastSoft() {
  React.useEffect(() => {
    const options = { toasterId: TOASTER, duration: Infinity }
    toast.info("Eşitleme sıraya alındı", { ...options, id: "soft-info", description: "Yaklaşık 2 dakika içinde başlar." })
    toast.error("Kaydedilemedi", {
      ...options,
      id: "soft-error",
      description: "Bağlantı koptu. Tekrar deneyin.",
      action: { label: "Tekrar dene", onClick: () => toast.dismiss("soft-error") },
    })
    toast.success("Ayarlar kaydedildi", { ...options, id: "soft-success" })
  }, [])

  return (
    <div className="relative mx-auto h-56 w-full max-w-[400px]">
      <Toaster id={TOASTER} variant="soft" expand position="bottom-center" offset={0} className="absolute! inset-0! w-full! transform-none!" />
    </div>
  )
}
```

### Süre çubuğu

`<Toaster progress />` toast'ın altına süresini geri sayan 2px'lik bir çubuk ekler. İmleç toast'ların üzerindeyken durur (Sonner da süreyi durdurur), azaltılmış harekette gizlenir; süresiz ve yükleniyor toast'larda görünmez.

**Örnek: Süre çubuğu** (`toast/progress`) · [Canlı önizleme](https://builders.ikas.com/ui-preview/demo/toast/progress)

```tsx
import { toast } from "sonner"

import { Button } from "@/components/ui/button"
import { Toaster } from "@/components/ui/sonner"

const TOASTER = "toast-progress"

/** progress: a 2px bar counts down the duration and stops while the pointer is over the toasts. */
export default function ToastProgress() {
  return (
    <div className="flex flex-wrap items-center gap-2">
      <Button variant="outline" onClick={() => toast.success("Ayarlar kaydedildi", { toasterId: TOASTER })}>
        Kaydet (4 sn)
      </Button>
      <Button
        variant="outline"
        onClick={() =>
          toast.info("Rapor hazırlanıyor", {
            toasterId: TOASTER,
            description: "Hazır olduğunda e-posta ile göndereceğiz.",
            duration: 8000,
          })
        }
      >
        Rapor iste (8 sn)
      </Button>
      <Toaster id={TOASTER} progress />
    </div>
  )
}
```

### Aksiyon ve yükleniyor

Silmeden sonra "Geri al"; uzun işlerde toast.promise ile yükleniyor → tamamlandı.

**Örnek: Aksiyon ve yükleniyor** (`toast/actions`) · [Canlı önizleme](https://builders.ikas.com/ui-preview/demo/toast/actions)

```tsx
import { Trash2Icon } from "lucide-react"
import { toast } from "sonner"

import { Button } from "@/components/ui/button"

export default function ToastActions() {
  return (
    <div className="flex flex-wrap items-center gap-2">
      <Button
        variant="outline"
        color="red"
        onClick={() =>
          toast.success("Kural silindi", {
            description: "Düşük stok uyarısı",
            action: { label: "Geri al", onClick: () => toast("Kural geri yüklendi") },
            duration: 8000,
          })
        }
      >
        <Trash2Icon data-icon="inline-start" data-anim="wiggle" />
        Kuralı sil
      </Button>
      <Button
        onClick={() => {
          const sync = new Promise<number>((resolve) => setTimeout(() => resolve(1284), 1800))
          toast.promise(sync, {
            loading: "Ürünler eşitleniyor…",
            success: (count) => `${count.toLocaleString("tr-TR")} ürün eşitlendi`,
            error: "Eşitleme başarısız",
          })
        }}
      >
        Eşitlemeyi başlat
      </Button>
    </div>
  )
}
```

## Island Toast

Ekranın kenarında tek bir yığın halinde duran, "dynamic island" tarzı toast. 36px'lik bir hap olarak gelir; açıklaması veya aksiyonu olan toast 150ms sonra kendiliğinden açılır ve ayrılmadan 1,5 saniye önce tekrar katlanır. Yeni toast öne geçer, eskiler arkasına katlanır; hover veya odakla yığın liste olarak açılır ve tüm sayaçlar durur.

```bash
npx shadcn@latest add @ikas/island-toast
```

<Callout type="warning" title="Toaster ya da IslandToaster, ikisi birden değil">
Bir uygulamada tek bir geçici bildirim dili olsun. Kök layout'a ya `Toaster`'ı ya `IslandToaster`'ı koyun; ikisini yan yana kullanmayın.
</Callout>

**Örnek: Island Toast** (`island-toast/basic`) · [Canlı önizleme](https://builders.ikas.com/ui-preview/demo/island-toast/basic)

```tsx
import * as React from "react"

import { IslandToaster, island, type IslandPosition } from "@/components/ui/island-toast"
import { Button } from "@/components/ui/button"
import { SegmentedControl } from "@/components/ikas/segmented-control"

const TOASTER = "island-basic"
const options = { toasterId: TOASTER }
type Tone = "dark" | "light"
type Vertical = "top" | "bottom"
type Side = "left" | "center" | "right"

/** The page theme: the `dark` class on <html>. */
function subscribeTheme(onChange: () => void) {
  const observer = new MutationObserver(onChange)
  observer.observe(document.documentElement, { attributes: true, attributeFilter: ["class"] })
  return () => observer.disconnect()
}
const isDark = () => document.documentElement.classList.contains("dark")

/**
 * Every call in one place: the statuses, a promise that resolves in place, one action and
 * three in a row that fold behind each other (hover the stack to open it as a list). The tone
 * switch also switches the page theme, so each tone is shown on its own ground.
 */
export default function IslandToastBasic() {
  const dark = React.useSyncExternalStore(subscribeTheme, isDark, () => false)
  const tone: Tone = dark ? "dark" : "light"
  const [vertical, setVertical] = React.useState<Vertical>("top")
  const [side, setSide] = React.useState<Side>("center")

  // A stack on first paint, so the demo (and its thumbnail) is never an empty frame.
  // Fixed ids keep StrictMode's double effect from stacking duplicates.
  React.useEffect(() => {
    island.info("Eşitleme sıraya alındı", { ...options, id: "seed-info" })
    island.warning("3 ürün atlandı", { ...options, id: "seed-warning" })
    island.success("Ayarlar kaydedildi", { ...options, id: "seed-success" })
  }, [])

  const sync = () =>
    island.promise(
      new Promise<number>((resolve) => setTimeout(() => resolve(1284), 1800)),
      {
        loading: "Ürünler eşitleniyor",
        success: (count) => `${count.toLocaleString("tr-TR")} ürün eşitlendi`,
        error: "Eşitleme tamamlanmadı",
      },
      options
    )

  const burst = () => {
    island.info("Eşitleme sıraya alındı", { ...options, description: "Yaklaşık 2 dakika içinde başlar." })
    setTimeout(() => island.warning("3 ürün atlandı", { ...options, description: "Barkodu olmayan ürünler gönderilmedi." }), 350)
    setTimeout(() => island.success("Ayarlar kaydedildi", options), 700)
  }

  const action = () =>
    island.success("Kural silindi", {
      ...options,
      id: "rule-deleted",
      description: "Düşük stok uyarısı",
      action: { label: "Geri al", onClick: () => island("Kural geri yüklendi", options) },
    })

  return (
    <div className="flex w-full flex-col gap-5">
      <div className="relative h-72 w-full overflow-hidden rounded-xl border bg-muted/40">
        <IslandToaster id={TOASTER} tone={tone} position={`${vertical}-${side}` as IslandPosition} className="absolute" />
      </div>
      <div className="flex flex-col items-center gap-3">
        <div className="flex flex-wrap justify-center gap-2">
          <Button variant="outline" onClick={() => island.success("Ayarlar kaydedildi", options)}>
            Başarılı
          </Button>
          <Button variant="outline" onClick={() => island.error("Kaydedilemedi", { ...options, description: "Bağlantı koptu. Tekrar deneyin." })}>
            Hata
          </Button>
          <Button variant="outline" onClick={sync}>
            Promise
          </Button>
          <Button variant="outline" onClick={action}>
            Aksiyonlu
          </Button>
          <Button onClick={burst}>Art arda 3</Button>
        </div>
        <div className="flex flex-wrap justify-center gap-3">
          <SegmentedControl
            aria-label="Ton"
            mode="radio"
            size="sm"
            value={tone}
            onValueChange={(v) => {
              document.documentElement.classList.toggle("dark", v === "dark")
              action()
            }}
            options={[
              { value: "dark", label: "Siyah" },
              { value: "light", label: "Beyaz" },
            ]}
          />
          <SegmentedControl
            aria-label="Kenar"
            mode="radio"
            size="sm"
            value={vertical}
            onValueChange={(v) => {
              setVertical(v)
              action()
            }}
            options={[
              { value: "top", label: "Üst" },
              { value: "bottom", label: "Alt" },
            ]}
          />
          <SegmentedControl
            aria-label="Yan"
            mode="radio"
            size="sm"
            value={side}
            onValueChange={(v) => {
              setSide(v)
              action()
            }}
            options={[
              { value: "left", label: "Sol" },
              { value: "center", label: "Orta" },
              { value: "right", label: "Sağ" },
            ]}
          />
        </div>
        <p className="text-[13px] text-muted-foreground">Üstüne gelin: liste açılır. Öndekini kenara doğru kaydırın ya da Esc ile kapatın.</p>
      </div>
    </div>
  )
}
```

Kapatmak için toast kenara doğru kaydırılır (40px ya da hızlı bir fiske), kapatma butonu veya Esc kullanılır. Ters yöne kaydırma geri esner. Zıplayan (bounce'lu) yay yalnızca bu bileşende kullanılır; bkz. [Hareket](https://builders.ikas.com/tr/docs/app-development/ui-kit/motion).

## Kullanım ilkeleri

**Yapın:**

- Başlığı geçmiş zamanla yazın: "Kural silindi".
- Geri alınabilen işlemlere "Geri al" aksiyonu ekleyin.
- Durumu toast.success / warning / error ile verin; renk ve ikon oradan gelir.

**Yapmayın:**

- Hata düzeltme adımı gerektiren durumlar için toast kullanmayın; Banner kullanın.
- Aynı anda birden fazla toast tetiklemeyin.
- Toast'lara className ile renk vermeyin.

## API

### `Toaster`

Uygulamanın kök layout'unda bir kez. Sonner'ın Toaster prop'larının hepsini alır; ikas varsayılanları: sağ alt köşe, en fazla 3 görünür toast (`visibleToasts`), 10px aralık (`gap`). `theme` verilmezse `<html>` üzerindeki `dark` sınıfını izler.

| Prop | Tip | Varsayılan | Açıklama |
| --- | --- | --- | --- |
| `variant` | `"surface" \| "soft"` | `"surface"` | surface: kart, durum ikonda (warning ve error'da ince kenar). soft: soft Banner gibi durum tonlu yüzey ve aksiyon. |
| `progress` | `boolean` | `false` | Süreyi geri sayan 2px çubuk. Hover'da durur, azaltılmış harekette gizlenir. |

### `toast(title, options)`

<TypeTable type={{
  "description": {
    "type": "ReactNode",
    "description": "İkinci satır. Ne olduğunu veya ne kadarını söyleyin."
  },
  "action": {
    "type": "{ label, onClick }",
    "description": "Tek aksiyon, genelde \"Geri al\". Kartta nötr outline xs buton; soft'ta durum tonlu."
  },
  "duration": {
    "type": "number",
    "description": "Geri alınabilir işlemlerde 8000–10000 verin. progress çubuğu bu süreyi izler.",
    "default": "4000"
  },
  "toast.success / info / warning / error": {
    "type": "function",
    "description": "Durumu ikon (ve warning/error'da ince kenar) taşır; soft'ta tüm yüzey."
  },
  "toast.promise(promise, { loading, success, error })": {
    "type": "function",
    "description": "Yükleniyor durumundan sonuca geçen tek toast."
  }
}} />

### `IslandToaster`

`@/components/ui/island-toast` içinden, kök layout'ta bir kez.

| Prop | Tip | Varsayılan | Açıklama |
| --- | --- | --- | --- |
| `tone` | `"dark" \| "light"` | `"dark"` | dark: iki temada da koyu, opak yüzey. light: iki temada da beyaz yüzey. |
| `position` | `IslandPosition` | `"top-center"` | Yığının durduğu kenar ve taraf. Üstteki yığın aşağı, alttaki yukarı büyür. |
| `visibleToasts` | `number` | `3` | Aynı anda görünen toast sayısı: öndeki ve arkasına katlananlar. |
| `duration` | `number` | `4000` | Toast başına varsayılan süre (ms). Açıklamalı veya aksiyonlu toast 1,5 katı kadar kalır. |
| `offset` | `number` | `16` | Ekran kenarına uzaklık (px). |
| `id` | `string` | - | Yalnızca aynı toasterId ile gönderilen toast'ları gösterir. |
| `className` | `string` | - | On the viewport layer; pass `absolute` to pin the stack inside a positioned parent. |

### `island(title, options)`

<TypeTable type={{
  "description": {
    "type": "ReactNode",
    "description": "İkinci satır; toast açılınca görünür."
  },
  "action": {
    "type": "{ label, onClick }",
    "description": "Tek aksiyon. Çalıştıktan sonra toast kapanır."
  },
  "duration": {
    "type": "number",
    "description": "Toast'ın kalma süresi (ms). Infinity verilirse kapanmaz.",
    "default": "4000"
  },
  "id": {
    "type": "string | number",
    "description": "Aynı id ile tekrar gönderilen toast, yığındaki yerinde güncellenir."
  },
  "toasterId": {
    "type": "string",
    "description": "Toast'ı aynı id'ye sahip IslandToaster'a gönderir."
  },
  "onDismiss": {
    "type": "() => void",
    "description": "Toast ayrılınca çağrılır: süre dolunca, kaydırınca, kapatma butonunda veya island.dismiss ile."
  },
  "island.success / info / warning / error / loading": {
    "type": "function",
    "description": "Durumu ikon ve ton taşır."
  },
  "island.promise(promise, { loading, success, error })": {
    "type": "function",
    "description": "Yükleniyor durumundan sonuca geçen tek toast."
  },
  "island.dismiss(id)": {
    "type": "function",
    "description": "Toast'ı kapatır; id verilmezse hepsini kapatır."
  }
}} />
