Skip to main content

Composant de toast

Dernière mise à jour:

Toast CSS Tailwind CSS uniquement pour le positionnement des notifications : positionnement en haut, en bas, en début, en fin et au centre. Pas de JavaScript pour la mise en page. WCAG AA accessible, fonctionne avec Django, HTMX, Laravel, React et n'importe quelle pile.

Les composants Toast affichent des notifications brèves et non intrusives positionnées sur les bords de l'écran. Construits avec des composants de positionnement et d'alerte fixes, les toasts communiquent les commentaires du système tels que les confirmations de succès, les messages d'erreur ou les mises à jour de statut. Le système de pain grillé Frutjam prend en charge six positions de placement, idéal pour les soumissions de formulaires, les opérations asynchrones et les notifications en temps réel.

CSS uniquement, aucun JavaScript requis. WCAG AA accessible et indépendant du framework : fonctionne avec Django, HTMX, Laravel, React et n'importe quelle pile.

ClasseTypeDescription
toastBaseConteneur de notification à position fixe
toast-topModificateurAncrages au sommet de la fenêtre
toast-bottomModificateurAncrages au bas de la fenêtre (par défaut)
toast-startModificateurAncres à gauche
toast-centerModificateurCentré horizontalement
toast-endModificateurAncrages à droite (par défaut)
toast-middleModificateurCentré verticalement
toast-slide-upModificateurEntre par le bas, par sa propre hauteur
toast-slide-downModificateurEntrées par le haut
toast-slide-startModificateurEntre par la gauche, par la droite dans RTL
toast-slide-endModificateurEntre par la droite, par la gauche dans RTL
--toast--widthTailleLargeur maximale de chaque toast, 24rem par défaut

Utilisation de base

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>
    </>
  )
}

Positions de toast

Principales positions

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>

.

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>

Centré

Un modificateur horizontal et un modificateur vertical se combinent, donc toast-center toast-middle met un toast au milieu de l'écran.

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>

Animation d’entrée

Chaque toast s'estompe et se met en place tout seul. Il n'y a rien à ajouter pour cela, et aucune classe pour l'activer.

La toast-slide-* les modificateurs sont pour quand vous voulez une direction différente de la montée par défaut. Choisissez le bord sur lequel repose le pain grillé, de sorte qu'il pénètre de l'extérieur de l'écran plutôt que de le traverser : toast-slide-end appartient à toast-end, toast-slide-down avec 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>

La distance est la largeur ou la hauteur du pain grillé, et non la distance jusqu'au bord de l'écran, de sorte qu'un pain grillé centré commence près du milieu plutôt qu'en dehors de l'écran.

Il n'y a pas d'animation de sortie. Un toast disparaît au moment où il est supprimé de la page, car CSS n'a pas d'état de transition. Fading one out signifie le garder dans le Dom et l'animer soi-même.

L'animation est ignorée pour tous ceux qui ont demandé un mouvement réduit.

Largeur

Chaque toast est plafonné à 24rem afin qu'un message long ne s'étende pas sur un écran de téléphone. Remplacer --toast--width pour le changer.

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>

Couleurs de toast

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>

Toasts multiples

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>

Vous utilisez Claude Code, Cursor ou un autre éditeur d'IA ?

Cherry MCP donne à votre éditeur d'IA les noms et la structure exacts des classes Tartine sur demande. Fini les cours hallucinés.

Essayez Cherry MCP

Found this useful?

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