JS Module

Y2Alert Framework

Sistema de notificações toast completo. 5 tipos, 6 posições, progress bar, caixa de confirmação com focus trap ✨ zero dependências, zero CSS externo (injetado automaticamente).

1. Tipos

5 variantes semânticas + aliases em PT-BR.

Demo ✨ clique para disparar

// Métodos principais
Y2Alert.ok('Salvo com sucesso!');
Y2Alert.err('Falha na requisição.');
Y2Alert.ale('Atenção necessária.');
Y2Alert.inf('Nova mensagem recebida.');
Y2Alert.drk('Notificação silenciosa.');

// Aliases PT-BR
Y2Alert.sucesso('Dados atualizados!');
Y2Alert.erro('Não foi possível salvar.');
Y2Alert.alerta('Verifique os campos.');
Y2Alert.info('Processando...');

2. Posições

9 posições ✨ topo, centro e base - esquerdo/centro/direito.

Demo ✨ clique em qualquer célula

// 3º parâmetro = posição
// Topo:   'tl' | 'tc' | 'tr'
// Centro: 'cl' | 'cc' | 'cr'
// Base:   'bl' | 'bc' | 'br'
// Padrão: 'tr'

Y2Alert.ok('Salvo!', 3000, 'bl');   // base esquerdo
Y2Alert.err('Erro!', 5000, 'cc');   // centro tela

3. Duração + Título

Controle preciso de timing e suporte a títulos.

Duração personalizada

Com título

// Assinatura completa
Y2Alert.ok(msg, duração_ms, posição, título)

// dur = 0 — não fecha automaticamente
Y2Alert.drk('Aguardando confirmação...', 0, 'tr');

// Com título
Y2Alert.ok(
    'Arquivo enviado com sucesso.',
    4000, 'tr',
    'Upload completo'
);

4. Caixa de Confirmação

Dialog modal com focus trap, ESC para cancelar e callback.

Demo

Y2Alert.confirmar(
    'Tem certeza que deseja deletar?',   // mensagem
    (confirmado) => {                    // callback
        if (confirmado) {
            deletarRegistro();
            Y2Alert.ok('Deletado!');
        }
    },
    'Deletar registro',  // título (opcional, padrão: 'Confirmação')
    '✨'                 // ícone  (opcional, padrão: '✨')
);

5. Atributo HTML

Dispare alertas direto no HTML sem escrever JS.

Demo

6. Quick Reference

Método Parâmetros Descrição
Y2Alert.ok() msg, dur?, pos?, title? Toast verde — sucesso
Y2Alert.err() msg, dur?, pos?, title? Toast vermelho — erro
Y2Alert.ale() msg, dur?, pos?, title? Toast amarelo — alerta
Y2Alert.inf() msg, dur?, pos?, title? Toast azul — informação
Y2Alert.drk() msg, dur?, pos?, title? Toast neutro — silencioso
Y2Alert.sucesso() msg, dur?, pos? Alias PT-BR de .ok()
Y2Alert.erro() msg, dur?, pos? Alias PT-BR de .err()
Y2Alert.alerta() msg, dur?, pos? Alias PT-BR de .ale()
Y2Alert.info() msg, dur?, pos? Alias PT-BR de .inf()
Y2Alert.confirmar() msg, cb, title?, icon? Dialog com callback booleano
Parâmetro Tipo Padrão Valores
msg string "" (vazio) HTML aceito
dur number 4000 ms — 0 = persistente
pos string 'tr' tl — tc — tr — cl — cc — cr — bl — bc — br
title string '' Texto do cabeçalho