Skip to main content

Składnik tostów

Ostatnia aktualizacja:

Toast CSS Tailwind tylko dla CSS do pozycjonowania powiadomień: góra, dół, początek, koniec i położenie na środku. Brak JavaScriptu dla układu. Dostępny WCAG AA, współpracuje z Django, HTMX, Laravel, React i dowolnym stosem.

Komponenty Toast wyświetlają krótkie, nieinwazyjne powiadomienia umieszczone na krawędziach ekranu. Zbudowane ze stałych elementów pozycjonujących i alertów, tosty przekazują informacje zwrotne od systemu, takie jak potwierdzenia powodzenia, komunikaty o błędach lub aktualizacje statusu. System tostów Frutjam obsługuje sześć pozycji umieszczenia, idealnych do przesyłania formularzy, operacji asynchronicznych i powiadomień w czasie rzeczywistym.

Tylko CSS, nie wymaga JavaScript. Dostępny w WCAG AA i niezależny od frameworka: współpracuje z Django, HTMX, Laravel, React i dowolnym stosem.

KlasaTypOpis
toastOpieraćKontener powiadomień o stałej pozycji
toast-topModyfikatorZakotwiczenia na górze rzutni
toast-bottomModyfikatorZakotwiczenia na dole rzutni (domyślne)
toast-startModyfikatorKotwice po lewej stronie
toast-centerModyfikatorPoziomo wyśrodkowany
toast-endModyfikatorKotwice po prawej stronie (domyślne)
toast-middleModyfikatorPionowo wyśrodkowany
toast-slide-upModyfikatorWejście od dołu, na własną wysokość
toast-slide-downModyfikatorWchodzi od góry
toast-slide-startModyfikatorWchodzi od lewej, od prawej w RTL
toast-slide-endModyfikatorWchodzi z prawej, z lewej strony w RTL
--tosty--szerokośćRozmiarMaksymalna szerokość każdego tosta, 24rem domyślnie

Podstawowe użycie

New message arrived.
1
2
3
4
5
<div role="status" aria-live="polite" class="toast">
  <div class="alert alert-info">
    <span>New message arrived.</span>
  </div>
</div>
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
import { useToast } from 'frutjam/react'

export default function ToastDemo() {
  const toast = useToast()
  return (
    <>
      <button className="btn" onClick={() => toast.info('New message arrived.')}>Show Toast</button>
      <div role="status" aria-live="polite" className="toast">
        {toast.toasts.map(t => (
          <div key={t.id} className={`alert${t.type ? ` alert-${t.type}` : ''}`}>
            <span>{t.message}</span>
          </div>
        ))}
      </div>
    </>
  )
}

Pozycje tostowe

Najlepsze pozycje

Top Start
Top Center
Top End
html
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
<div role="status" aria-live="polite" class="toast toast-top toast-start">
  <div class="alert alert-info"><span>Top Start</span></div>
</div>

<div role="status" aria-live="polite" class="toast toast-top toast-center">
  <div class="alert alert-info"><span>Top Center</span></div>
</div>

<div role="status" aria-live="polite" class="toast toast-top toast-end">
  <div class="alert alert-info"><span>Top End</span></div>
</div>

Dolne pozycje

Bottom Start
Bottom Center
Bottom End
html
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
<div role="status" aria-live="polite" class="toast toast-bottom toast-start">
  <div class="alert alert-info"><span>Bottom Start</span></div>
</div>

<div role="status" aria-live="polite" class="toast toast-bottom toast-center">
  <div class="alert alert-info"><span>Bottom Center</span></div>
</div>

<div role="status" aria-live="polite" class="toast toast-bottom toast-end">
  <div class="alert alert-info"><span>Bottom End</span></div>
</div>

Wyśrodkowany

Modyfikator poziomy i pionowy łączą się, tzw toast-center toast-middle stawia toast na środku ekranu.

Middle Center
html
1
2
3
<div role="status" aria-live="polite" class="toast toast-middle toast-center">
  <div class="alert alert-info"><span>Middle Center</span></div>
</div>

Animacja wejścia

Każdy tost zanika i samoczynnie unosi się na swoim miejscu. Nie ma nic do dodania i nie ma klasy, która by to włączyła.

The toast-slide-* modyfikatory są przydatne, gdy chcesz mieć inny kierunek niż domyślny wzrost. Wybierz krawędź, na której leży tost, tak aby wchodził spoza ekranu, a nie przez niego: toast-slide-end należy z toast-end, toast-slide-down z toast-top.

Drops in from the top
html
1
2
3
<div role="status" aria-live="polite" class="toast toast-top toast-end toast-slide-down">
  <div class="alert alert-info"><span>Drops in from the top</span></div>
</div>

Odległość to szerokość lub wysokość tostu, a nie odległość do krawędzi ekranu, zatem toast wyśrodkowany zaczyna się w pobliżu środka, a nie poza ekranem.

Brak animacji wyjścia. Toast znika w momencie usunięcia go ze strony, ponieważ CSS nie ma stanu, z którego można przejść. Wygaszenie jednego oznacza pozostawienie go w DOM i samodzielne animowanie.

Animacja jest pomijana w przypadku każdego, kto poprosił o ograniczenie ruchu.

Szerokość

Każdy toast jest ograniczony 24rem więc długa wiadomość nie zajmuje całego ekranu telefonu. Prześcigać --toast--width żeby to zmienić.

html
1
2
3
<div role="status" aria-live="polite" class="toast [--toast--width:32rem]">
  <div class="alert alert-info"><span>A wider toast.</span></div>
</div>

Kolory tostów

File saved successfully.
Storage is almost full.
Connection failed.
Update available.
html
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
<div role="status" aria-live="polite" class="toast toast-top toast-end">
  <div class="alert alert-success">
    <span>File saved successfully.</span>
  </div>
  <div class="alert alert-warning">
    <span>Storage is almost full.</span>
  </div>
  <div class="alert alert-error">
    <span>Connection failed.</span>
  </div>
  <div class="alert alert-info">
    <span>Update available.</span>
  </div>
</div>

Wiele tostów

Profile updated.
2 new notifications.
html
1
2
3
4
5
6
7
8
<div role="status" aria-live="polite" class="toast toast-top toast-end">
  <div class="alert alert-success">
    <span>Profile updated.</span>
  </div>
  <div class="alert alert-info">
    <span>2 new notifications.</span>
  </div>
</div>

Używasz kodu Claude'a, kursora lub innego edytora AI?

Cherry MCP na żądanie udostępnia edytorowi AI dokładne nazwy i strukturę klas Toast. Żadnych więcej zajęć z halucynacjami.

Try Cherry MCP

Found this useful?

Star Frutjam on GitHub. It's how other developers discover it.