Detalhes do pacotev3.0.1

status_alert

Exiba alertas de status semelhantes ao sistema da Apple, que se escondem automaticamente. É muito adequado para notificar o usuário sem interromper seu fluxo.

AndroidiOSWebmacOSWindowsLinux

pub.dev Documentação da API Código-fonte

Downloads em 30 dias: 698
Curtidas: 287
Pontos Pub: 160

Instalar pacote

flutter pub add status_alert

Visão geral do pacote

Orientação gerada a partir de informações públicas. Apenas para referência.

Um pacote Flutter que exibe alertas de status com estilo do sistema, auto-ocultos, inspirados na interface da Apple. Essas notificações não intrusivas aparecem brevemente no topo da tela e desaparecem automaticamente, sendo ideais para fornecer feedback sem interromper o fluxo do usuário. Projetado com uma estética limpa e minimalista, oferece suporte a múltiplas plataformas, incluindo Android, iOS, Web, macOS, Windows e Linux. O pacote é leve e fácil de integrar, com animações suaves e comportamento confiável em diferentes dispositivos.

Casos de uso

Exibindo mensagens de sucesso após o envio do formulário
Mostrando notificações de erro temporárias
Fornecendo feedback sobre ações do usuário
Informando usuários sobre atualizações de processo em segundo plano
Melhorando a UX com alertas sutis e não bloqueantes

Principais recursos

Notificações de auto-escondimento
Design visual estilo Apple
Compatibilidade multiplataforma
Animações suaves de desvanecimento para dentro e para fora
API simples com configuração mínima
Duração e posição configuráveis

Indicado para

Aplicativos que exigem feedback leve
Desenvolvedores que priorizam a experiência do usuário
Projetos direcionados a múltiplas plataformas
Interfaces de usuário onde interrupções devem ser evitadas
Equipes que desejam estilo de alerta semelhante ao nativo

Considerações

Não adequado para alertas persistentes ou críticos
Personalização limitada além do estilo básico
Requer contexto adequado para posicionamento correto
Pode não funcionar como esperado em árvores de widgets complexas
Melhor usado para mensagens de curta duração e não urgentes

README original

Snapshot do README original do repositório-fonte vinculado. Consulte o repositório para o conteúdo mais recente.

Status Alert for Flutter

Display Apple system-like self-hiding status alerts. Well suited for notifying users without interrupting their flow.

Installing

dependencies:
  status_alert: ^2.0.0

import 'package:status_alert/status_alert.dart';

Basic Usage

StatusAlert.show(
  context,
  duration: Duration(seconds: 2),
  title: 'Subscribed',
  subtitle: 'You will be notified of new posts',
  configuration: IconConfiguration(icon: Icons.done),
  maxWidth: 260,
);

Parameters

Parameter	Type	Default	Description
`title`	`String?`	`null`	Main text
`subtitle`	`String?`	`null`	Secondary text
`configuration`	`PopupMediaConfiguration?`	`null`	Icon or custom widget
`duration`	`Duration`	`1300ms`	How long the alert stays visible
`backgroundColor`	`Color?`	Theme-based	Alert background
`blurPower`	`double`	`2.0`	Background blur sigma
`maxWidth`	`double?`	`null`	Max width on large screens
`alignment`	`Alignment`	`center`	Alert position on screen
`margin`	`EdgeInsets`	`all(40)`	Outer spacing
`padding`	`EdgeInsets`	`all(30)`	Inner spacing
`borderRadius`	`BorderRadius`	`circular(10)`	Corner radius
`dismissOnBackgroundTap`	`bool`	`false`	Dismiss when background is tapped
`onComplete`	`VoidCallback?`	`null`	Called after dismiss animation ends
`titleOptions`	`StatusAlertTextConfiguration?`	`null`	Title text styling
`subtitleOptions`	`StatusAlertTextConfiguration?`	`null`	Subtitle text styling

Media Configurations

Icon

StatusAlert.show(
  context,
  title: 'Done',
  configuration: IconConfiguration(
    icon: Icons.check_circle,
    color: Colors.green,
    size: 60,
  ),
);

Custom Widget (e.g. Rive animation)

StatusAlert.show(
  context,
  title: 'Loading',
  configuration: WidgetConfiguration(
    widget: RiveAnimation.asset('assets/animation.riv'),
  ),
);

Programmatic Control

// Show
StatusAlert.show(context, title: 'Saved');

// Hide manually
StatusAlert.hide();

// Check visibility
if (StatusAlert.isVisible) { ... }

`onComplete` Callback

Called after the alert finishes its dismiss animation:

StatusAlert.show(
  context,
  title: 'Uploaded',
  onComplete: () => Navigator.push(context, ...),
);

Migration from 1.x

1.x	2.x
`FlareConfiguration`	Use `WidgetConfiguration` with a Rive widget
`textScaleFactor` in `StatusAlertTextConfiguration`	Use `textScaler`
Dart SDK `<3.0.0`	Requires Dart `>=3.0.0`