README

FluiToast4D

O FluiToast4D é um componente moderno e altamente customizável para exibição de notificações (Toasts) não intrusivas no Delphi. Projetado para oferecer uma experiência de usuário rica, ele permite tanto o uso no padrão visual (Design-Time via Object Inspector) quanto o uso via código através de uma poderosa e limpa Interface Fluente (Fluent API).

✨ Características e Recursos

• Design Moderno: Renderização suavizada com GDI+ e cantos perfeitamente arredondados.
• Responsivo: A altura do Toast se adapta dinamicamente ao tamanho do texto da mensagem. Se não houver mensagem, o título é elegantemente centralizado na vertical.
• Suporte a Imagens: Permite a exibição de ícones/imagens (PNG, JPEG, etc.) no lado esquerdo do Toast.
• Empilhamento Inteligente: Múltiplos Toasts podem ser exibidos simultaneamente sem se sobrepor, independente de seus tamanhos variáveis.
• Personalização Total: Controle completo sobre cores, fontes, bordas e tempos de duração.
• Callbacks: Suporte a ações personalizadas ao clicar no Toast.

🚀 Como Usar

O FluiToast4D pode ser usado de duas formas: instanciando um componente no Form ou gerando Toasts dinâmicos via código.

1. Via Código (Fluent API)

A Fluent API é ideal para criar alertas dinâmicos e rápidos durante a execução do sistema.

uses
  FluiToast, FluiToast.Types;

procedure TForm1.ShowSuccessToast;
begin
  TFluiToast.New
    .Title('Salvo com êxito')
    .Message('O registro foi gravado no banco de dados com sucesso.')
    .ToastType(ftSuccess)
    .Position(ftpBottomRight)
    .Duration(4000) // 4 segundos
    .Show;
end;

procedure TForm1.ShowToastWithImage(MyImage: TImage);
begin
  TFluiToast.New
    .Title('Novo E-mail')
    .Message('Você tem uma nova mensagem na sua caixa de entrada.')
    .Image(MyImage) // Aceita tanto um TImage quanto um TPicture (MyImage.Picture)
    .Show;
end;

2. Via Componente (Object Inspector)

Você pode arrastar o componente TFluiToast para o seu formulário. Configure as propriedades visuais (como Cores, Fontes, e a Imagem Padrão) pelo Object Inspector.

No código, você só precisa chamar:

procedure TForm1.ButtonShowClick(Sender: TObject);
begin
  // Usa as configurações pré-definidas no Object Inspector
  FluiToast1.Show;
  
  // Ou você pode sobrescrever as propriedades antes de mostrar:
  // FluiToast1.Title('Aviso Customizado').Show;
end;

⚙️ Propriedades e Métodos

Abaixo estão listadas as propriedades disponíveis no Object Inspector e seus métodos equivalentes na Fluent API.

🛠️ Exemplo Avançado (Callback)

TFluiToast.New
  .Title('Atualização Disponível')
  .Message('Clique aqui para reiniciar o sistema.')
  .ToastType(ftInfo)
  .OnClick(
    procedure
    begin
      ShowMessage('Reiniciando o sistema...');
    end
  )
  .Show;