https://github.com/edinelsonslima/toast-notification
Biblioteca de toast notifications
https://github.com/edinelsonslima/toast-notification
library react toast-notifications typescript vite
Last synced: 5 months ago
JSON representation
Biblioteca de toast notifications
- Host: GitHub
- URL: https://github.com/edinelsonslima/toast-notification
- Owner: edinelsonslima
- Created: 2023-12-06T20:46:29.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2025-04-06T15:32:47.000Z (about 1 year ago)
- Last Synced: 2025-11-23T04:08:12.174Z (7 months ago)
- Topics: library, react, toast-notifications, typescript, vite
- Language: TypeScript
- Homepage: https://www.npmjs.com/package/@edinelsonslima/toast-notification
- Size: 222 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
Toast Notifications
## 👀 Links
- 🔗 [Apresentação do toast notification](https://edinelsonslima.github.io/lp-toast-notification/)
- 🔗 [NPM](https://www.npmjs.com/package/@edinelsonslima/toast-notification)
## ⤵️ Instalando
Adicionar com **yarn**
```
yarn add @edinelsonslima/toast-notification
```
Adicionar com **npm**
```
npm install @edinelsonslima/toast-notification
```
## 👨🏻💻 Modo de usar
- Adicione o componente `` em algum lugar da sua aplicação;
- Importe os estilos css de `import '@edinelsonslima/toast-notification/dist/style.css'`;
```tsx
import { ToastContainer } from '@edinelsonslima/toast-notification';
import '@edinelsonslima/toast-notification/dist/style.css';
export default function App(){
//seu código
return (
<>
>
)
}
```
- Disparando os toast com a função `toast` de dentro do `@edinelsonslima/toast-notification`
```tsx
import { toast } from '@edinelsonslima/toast-notification';
export default function MyComponent(){
//seu código
const exampleToast = () => {
toast.success({ content: "Mensagem de exemplo" })
}
return (
//seu código
)
}
```
## 🧐 Informações adicionais
#### O que é disponível com o pacote
| função | propriedades |
|--------------------|------------------------------------------------------------|
| ToastContainer | `classNames` `position` `defaultDuration` |
| toast | `content` `type` `duration` |
| style | `/dist/style.css` |
#### As propriedades da função toast
|propriedade | toast |
|--------------------|----------------------------------------------------------- |
| content | A conteúdo que aparecerá dentro do toast |
| type | Define o tipo de toast que é para aparecer |
| duration | O tempo que o toast irá permanecer em tela |
#### As propriedades do componente ToastContainer
|propriedade | ToastContainer |
|--------------------|----------------------------------------------------------- |
| classNames | Um objeto de **chave:valor** onde a chave é o tipo de toast e o valor pode ser uma string (classNames) ou um objeto (CSSProperties) |
| position | Define em qual parte da tela irá aparecer a toast notification, existe valores predefinidos |
| defaultDuration | Define tempo padrão de duração de todas as toast |
#### Mais detalhes sobre as propriedades
| propriedade |tipo | é obrigatório | padrão |
|-----------------|---------|-----------------|-------------|
| content |ReactNode| sim | - |
| type |string | sim | - |
| duration |number | não | 7_0000 |
| defaultDuration |number | não | - |
| classNames |object | não | undefined |
| position |string | não | right-top |
ℹ️ O `duration` e `defaultDuration` estão em ms (milissegundos)
ℹ️ A função `toast` pode ser chamada de algumas formas, veja os exemplos a seguir:
caso seja chamada direta, será obrigatório informa o **type**
```ts
toast({ content: "mensagem exemplo", type: "info", duration: 1000 * 4 })
```
ou pode acessar o tipo do toast diretamente, assim omitindo ele do objeto enviado
```ts
toast.info({ content: "mensagem exemplo", durantino: 1000 * 4 })
```
```ts
toast.info('mensagem exemplo')
```
```tsx
toast.info(mensagem exemplo)
```
```tsx
toast.info(mensagem exemplo)
```