Lewati ke konten
MarkasUI
Ketik untuk mencari

    Panduan

    MarkasUI

    Form

    Feedback

    Overlay

    Navigasi

    Data

    Section

    Animasi

    Latar

    Tombol

    Template

    Halaman

    Toast

    Notifikasi singkat di pojok kanan bawah yang hilang sendiri, dipicu lewat fungsi toast() atau event.

    <div class="flex flex-wrap items-center gap-3" x-data>
        <x-markas.button x-on:click="$dispatch('markas-toast', { title: 'Changes saved', description: 'Your profile has been updated', variant: 'success', duration: 0 })">Show toast</x-markas.button>
        <x-markas.button variant="secondary" x-on:click="$dispatch('markas-toast', { title: 'Draft saved automatically' })">Temporary toast</x-markas.button>
    </div>
    <x-markas.toast />
    import { Button } from "@/components/markas/Button";
    import { Toaster, toast } from "@/components/markas/Toast";
    
    export default function ToastExample() {
      return (
        <>
          <div className="flex flex-wrap items-center gap-3">
            <Button
              onClick={() =>
                toast({
                  title: "Changes saved",
                  description: "Your profile has been updated",
                  variant: "success",
                  duration: 0,
                })
              }
            >
              Show toast
            </Button>
            <Button
              variant="secondary"
              onClick={() => toast({ title: "Draft saved automatically" })}
            >
              Temporary toast
            </Button>
          </div>
          <Toaster />
        </>
      );
    }
    <script setup lang="ts">
    import Button from "@/components/markas/Button.vue";
    import Toaster, { toast } from "@/components/markas/Toast.vue";
    </script>
    
    <template>
      <div class="flex flex-wrap items-center gap-3">
        <Button
          @click="
            toast({
              title: 'Changes saved',
              description: 'Your profile has been updated',
              variant: 'success',
              duration: 0,
            })
          "
        >
          Show toast
        </Button>
        <Button
          variant="secondary"
          @click="toast({ title: 'Draft saved automatically' })"
        >
          Temporary toast
        </Button>
      </div>
      <Toaster />
    </template>
    <script lang="ts">
      import Button from "$lib/components/markas/Button.svelte";
      import Toaster, { toast } from "$lib/components/markas/Toast.svelte";
    </script>
    
    <div class="flex flex-wrap items-center gap-3">
      <Button
        onclick={() =>
          toast({
            title: "Changes saved",
            description: "Your profile has been updated",
            variant: "success",
            duration: 0,
          })}>Show toast</Button
      >
      <Button
        variant="secondary"
        onclick={() => toast({ title: "Draft saved automatically" })}
        >Temporary toast</Button
      >
    </div>
    <Toaster />
    ---
    import Button from "@/components/markas/Button.astro";
    import Toaster from "@/components/markas/Toast.astro";
    ---
    
    <div class="flex flex-wrap items-center gap-3">
      <Button data-toast={JSON.stringify({ title: "Changes saved", description: "Your profile has been updated", variant: "success", duration: 0 })}>Show toast</Button>
      <Button variant="secondary" data-toast={JSON.stringify({ title: "Draft saved automatically" })}>Temporary toast</Button>
    </div>
    <Toaster />
    
    <script>
      // Toaster listens for the markas-toast event on window.
      document.addEventListener("click", (event) => {
        const button = (event.target as Element).closest<HTMLElement>("[data-toast]");
        if (!button) return;
        window.dispatchEvent(
          new CustomEvent("markas-toast", { detail: JSON.parse(button.dataset.toast!) }),
        );
      });
    </script>
    import { Component } from "@angular/core";
    import { Button } from "./markas/button.component";
    import { Toaster, toast } from "./markas/toast.component";
    
    @Component({
      selector: "markas-example",
      imports: [Button, Toaster],
      template: `
        <div class="flex flex-wrap items-center gap-3">
          <button
            markas-button
            (click)="
              toast({
                title: 'Changes saved',
                description: 'Your profile has been updated',
                variant: 'success',
                duration: 0,
              })
            "
          >
            Show toast
          </button>
          <button
            markas-button
            variant="secondary"
            (click)="toast({ title: 'Draft saved automatically' })"
          >
            Temporary toast
          </button>
        </div>
        <markas-toaster />
      `,
    })
    export default class ToastExample {
      protected readonly toast = toast;
    }

    Contoh

    Varian

    Dengan deskripsi

    Durasi

    Instalasi

    npx markasui@latest add toast

    Pemakaian

    Pasang region sekali di layout, misalnya sebelum </body>:

    <x-markas.toast
        :initial="session('toast') ? [session('toast')] : []"
        close-label="Tutup"
        region-label="Notifikasi"
    />

    Picu toast dari Alpine atau JavaScript biasa:

    <x-markas.button x-data x-on:click="$dispatch('markas-toast', { title: 'Perubahan disimpan', variant: 'success' })">Simpan</x-markas.button>
    window.dispatchEvent(
      new CustomEvent("markas-toast", {
        detail: { title: "Gagal mengirim", variant: "danger", duration: 0 },
      }),
    );

    Butuh Alpine.js. Livewire 3 dan 4 sudah membawa Alpine, jadi tidak perlu dipasang lagi.

    Livewire

    $this->dispatch('markas-toast', title: 'Saved', variant: 'success');

    Livewire 3 dan 4 memancarkan event browser di window, jadi toast bisa langsung dari action komponen. Pasang <x-markas.toast /> sekali di layout.

    import { Toaster, toast } from "@/components/markas/Toast";
    
    // Di layout
    <Toaster closeLabel="Tutup" regionLabel="Notifikasi" />;
    
    // Di mana saja
    toast({
      title: "Perubahan disimpan",
      description: "Profil Anda sudah diperbarui.",
      variant: "success",
    });
    <script setup lang="ts">
    import Toaster, { toast } from "@/components/markas/Toast.vue";
    </script>
    
    <template>
      <Button @click="toast({ title: 'Perubahan disimpan', variant: 'success' })">
        Simpan
      </Button>
      <Toaster close-label="Tutup" region-label="Notifikasi" />
    </template>
    <script lang="ts">
      import Button from "$lib/components/markas/Button.svelte";
      import Toaster, { toast } from "$lib/components/markas/Toast.svelte";
    </script>
    
    <Button onclick={() => toast({ title: "Changes saved", variant: "success" })}>
      Save
    </Button>
    <Toaster />
    ---
    import Toaster from "@/components/markas/Toast.astro";
    ---
    
    <!-- In the layout -->
    <Toaster />
    
    <script>
      // Anywhere in the browser
      window.dispatchEvent(
        new CustomEvent("markas-toast", {
          detail: { title: "Changes saved", variant: "success" },
        }),
      );
    </script>

    Komponen Astro tidak bisa mengekspor fungsi ke halaman, jadi Toaster Astro mendengarkan event markas-toast yang sama dengan Blade. Prop initial menampilkan toast langsung.

    import { Component } from "@angular/core";
    import { Button } from "./markas/button.component";
    import { Toaster, toast } from "./markas/toast.component";
    
    @Component({
      selector: "app-root",
      imports: [Button, Toaster],
      template: `
        <button markas-button (click)="save()">Save</button>
        <markas-toaster />
      `,
    })
    export class App {
      save() {
        toast({ title: "Changes saved", variant: "success" });
      }
    }
    • Detail toast: title, description, variant (default, success, danger), dan duration dalam milidetik (default 5000, 0 berarti tetap tampil sampai ditutup).
    • Timer berhenti saat toast di-hover atau berisi fokus.
    • toast() mengembalikan id. Di React dan Vue, panggil dismissToast(id) untuk menutup dari kode.
    • Antrean toast disimpan di level modul, jadi cukup satu Toaster per aplikasi.
    • Panggil toast() hanya di browser, misalnya di event handler, useEffect (React), atau onMounted (Vue). Saat render di server (SSR) toast() tidak melakukan apa pun dan mengembalikan 0.
    • Label region default dalam bahasa Inggris (“Notifications”) dan tombol tutup “Close”. Isi regionLabel dengan “Notifikasi” dan closeLabel dengan “Tutup” (Blade: region-label, close-label) untuk situs berbahasa Indonesia.

    Props

    NamaTipeDefaultKeterangan
    titlestring-Judul toast. Opsi untuk toast() atau detail event markas-toast (Blade, Astro).
    descriptionstring-Teks pendukung di bawah judul.
    variant'default' | 'success' | 'danger'defaultWarna border dan ikon.
    durationnumber5000Milidetik sebelum toast hilang sendiri. 0 berarti tetap tampil sampai ditutup.
    initialarray[]Khusus Blade dan Astro: daftar toast yang langsung tampil, misalnya dari flash session.
    closeLabelstringCloseLabel aksesibel tombol tutup di setiap toast. Isi "Tutup" untuk situs berbahasa Indonesia.
    regionLabelstringNotificationsLabel aksesibel region live. Isi "Notifikasi" untuk situs berbahasa Indonesia.

    Aksesibilitas

    • Region memakai role status dan aria-live polite, jadi toast baru dibacakan tanpa memindahkan fokus.
    • Timer berhenti saat toast di-hover atau berisi fokus, lalu lanjut setelah keduanya lepas.
    • Tombol tutup punya aria-label dari closeLabel (default Close) dan bisa dijangkau dengan Tab.
    • Animasi masuk dimatikan saat prefers-reduced-motion.

    Komponen terkait

    Komponen feedback lain dengan class yang sama di setiap framework.