Visão geral do React Toast
O React Toast é um componente pop-up super leve e pequeno usado para exibir o conteúdo de uma mensagem, notificando os usuários finais sobre o status de um registro alterado. Você pode posicionar e mostrar facilmente React notificações do sistema na parte inferior ou em qualquer outra área especificada da tela. Ou você também pode descartá-los de maneira simples e fácil.
O componente React Toast é usado principalmente para mensagens do sistema, notificações por push, mensagens de aviso e informações. Não pode ser descartado pelo usuário. Esse controle tem recursos diferentes, como efeitos de animação, propriedade de tempo de exibição para configurar por quanto tempo o componente da notificação do sistema fica visível, estilo e outros.
React Toast Example
Dê uma olhada no exemplo simples do Ignite UI for React Toast abaixo. A mensagem de notificação animada aparece depois de clicar no botão.
How To Use Ignite UI for React Toast Notification
Primeiro, você precisa instalar o pacote npm Ignite UI for React correspondente executando o seguinte comando:
npm install igniteui-react
Em seguida, você precisará importar o React IgrToast
, seu CSS necessário e registrar seu módulo, assim:
import { IgrToastModule, IgrToast } from 'igniteui-react';
import 'igniteui-webcomponents/themes/light/bootstrap.css';
IgrToastModule.register();
Para obter uma introdução completa ao Ignite UI for React, leia o tópico Introdução.
A maneira mais simples de exibir o componente de notificação do sistema é usar seu show
método e chamá-lo com um clique de botão.
<IgrButton variant="contained" clicked={this.onShowButtonClicked}>
<span>Show Toast</span>
</IgrButton>
<IgrToast ref={this.onToastRef}>
<span>Toast Message</span>
</IgrToast>
public onToastRef(toast: IgrToast) {
if (!toast) { return; }
this.toastRef = toast;
}
public onShowButtonClicked() {
if (this.toastRef) {
this.toastRef.show();
}
}
Examples
Properties
Use a displayTime
propriedade para configurar por quanto tempo o componente da notificação do sistema fica visível. Por padrão, ele é definido como 4000 milissegundos.
Por padrão, o componente de notificação do sistema é ocultado automaticamente após um período especificado pelo displayTime
. Você pode usar keepOpen
a propriedade para alterar esse comportamento. Dessa forma, a notificação do sistema permanecerá visível.
<div>
<IgrButton variant="contained" clicked={this.onToggleButtonClicked}>
<span>Toggle Toast</span>
</IgrButton>
<IgrButton variant="contained" clicked={this.onKeepOpenButtonClicked}>
<span>Toggle keepOpen Property</span>
</IgrButton>
<IgrButton variant="contained" clicked={this.onDisplayTimeButtonClicked}>
<span>Set DisplayTime to 8000</span>
</IgrButton>
</div>
<IgrToast ref={this.onToastRef}>
<span>Toast Message</span>
</IgrToast>
public onToastRef(toast: IgrToast) {
if (!toast) { return; }
this.toastRef = toast;
}
public onToggleButtonClicked() {
if (this.toastRef) {
this.toastRef.toggle();
}
}
public onKeepOpenButtonClicked() {
if (this.toastRef) {
this.toastRef.keepOpen = !this.toastRef.keepOpen;
}
}
public onDisplayTimeButtonClicked() {
if (this.toastRef) {
this.toastRef.displayTime = 8000;
}
}
Styling
Você pode estilizar as notificações React IgrToast
diretamente usando o seletor de tags:
igc-toast {
background-color: var(--ig-primary-500);
color: var(--ig-primary-500-contrast);
}