Messages Service

O serviço de mensagens é responsável por apresentar mensagens ao utilizador. Estas podem ser apenas de informação ou podem também ser de interação, necessitando de ação por parte do utilizador.

Tipos de mensagem

Mensagem de validação

Toast

Popup

API

var msgConfig = {
    title: 'Hello',
    detail: 'This is a test',
    type: 'info',
    callbacks: {
        ok: function () { },
        cancel: function () { },
        yes: function () { },
        no: function () { },
    },
    customAction: {
        header: 'Run action',
        callback: function () { },
    },
};

messagesService.showMessage(msgConfig);
messagesService.showModal(msgConfig);
messagesService.showToast(msgConfig);

A mensagem é apresentada de acordo com a configuração passada.

• title: titulo da mensagem
• detail: detalhe da mensagem
• type: tipo da mensagem (‘success’ || ‘info’ || ‘error’ || ‘warning’)
• callbacks: define as ações disponíveis ao utilizador
  • o ok, cancel, yes, no
• customAction: define uma ação custom para o utilizador

showMessage

Apresenta uma mensagem informativa ao utilizador. Quando necessário, é possível passar uma ação para ser executado pelo utilizador.

messagesService.showMessage({
    detail: 'Ocorreu um erro na ligação ao servidor.',
    type: 'warning',
    customAction: {
        header: 'Try again',
        callback: function () {
            console.log('Callback');
        },
    },
});

showToast

Apresenta uma mensagem no formato ‘toast’ ao utilizador.

messagesService.showToast({
title: 'Success',
detail: 'A fatura foi criada com sucesso.',
    type: 'success'
});

showModal

Apresenta uma mensagem ao utilizador num popup.

messagesService.showModal({
    title: 'O cliente excedeu o limite de crédito.',
    detail: 'Pretende continuar?',
    callbacks: {
        yes: function () {
            console.log('YES Callback');
        },
        no: function () {
            console.log('NO Callback');
        },
    }
});

São suportadas as seguintes funções de callback:

messagesService.showModal({
    callbacks: {
        yes: function () { },
        no: function () { },
        ok: function () { },
        cancel: function () { },
    }
});

Existe ainda a possibilidade de definir uma custom action:

messagesService.showModal({
    title: '...',
    customAction: {
        header: 'Action',
        callback: function () {
            console.log('CustomAction Callback');
        },
    },
});