Upload
Visão Geral
Design System
Exemplos
Básico
Copiar código
Resetar exemplo
Abrir no StackBlitz
Alternar fundo do preview
Estado
Copiar código
Resetar exemplo
Abrir no StackBlitz
Alternar fundo do preview
Propriedades
accept
| Atributo | accept |
| Descrição | Tipos de arquivo permitidos (ex.: 'image/*'). |
| Tipo | string |
| Valor padrão | '' |
customId
| Atributo | custom-id |
| Descrição | Identificador único do componente; gerado automaticamente quando omitido. |
| Tipo | string |
| Valor padrão | Helpers.generateUniqueId('br-upload') |
disabled
| Atributo | disabled |
| Descrição | Desativa interação e seleção de arquivos quando true. |
| Tipo | boolean |
| Valor padrão | false |
label
| Atributo | label |
| Descrição | Rótulo exibido acima do botão de upload. |
| Tipo | string |
| Valor padrão | 'Envio de arquivo' |
multiple
| Atributo | multiple |
| Descrição | Indica se o componente permite a seleção de múltiplos arquivos. Quando definido como true, o usuário pode selecionar mais de um arquivo para upload. |
| Tipo | boolean |
| Valor padrão | false |
state
| Atributo | state |
| Descrição | Estado visual: 'info', 'warning', 'danger' ou 'success'. |
| Tipo | "danger" | "info" | "success" | "warning" |
| Valor padrão | --- |
uploadFiles
| Atributo | upload-files |
| Descrição | Lista de arquivos já enviados (para edição ou pré-visualização). Pode ser uma string JSON ou um array de objetos IUploadFile. |
| Tipo | IUploadFile[] | string |
| Valor padrão | [] |
Slots
| Nome | Descrição |
|---|---|
"default" | Texto personalizado para o botão de upload. Se não fornecido, será exibido "Selecione o arquivo" como texto padrão. Use este slot para personalizar o texto do botão de acordo com o contexto do upload, por exemplo: "Anexar documentos", "Enviar imagens", etc. |
"upload-list" | Permite customizar a área de listagem de arquivos. Se utilizado, substitui a lista padrão gerada pelo componente. |
Eventos
| Evento | Descrição | Propagação |
|---|---|---|
brRemove | Evento emitido quando um arquivo da lista uploadFiles (externos) é removido pelo usuário. O objeto emitido contém os dados do arquivo removido. | true |
selectedFilesChange | Emitido quando a lista de arquivos selecionados muda. | true |