Skip to content

FileViewer

FileViewer é um componente que permite pré-visualizar ou fazer download de um arquivo.



Quando usar:

  • Quando for necessário apresentar uma imagem ao usuário, possibilitando que ele visualize sem a necessidade de baixá-la.
  • Quando for necessário apresentar um arquivo ao usuário e permitir que ele faça o download.
  • Para apresentar pré-visualizações de arquivos de imagem antes de baixar.
  • Quando o usuário precisa revisar rapidamente um arquivo sem abrir um aplicativo separado.

Quando não usar:

  • Quando for mais conveniente para o usuário ver a imagem diretamente sem precisar clicar no componente. Nesse caso, use o componente Image.
  • Quando o conteúdo não necessita de interatividade, como um ícone simples ou uma miniatura sem funcionalidade adicional.
  • Para arquivos muito grandes que podem demorar para carregar na pré-visualização. Nesse caso, forneça apenas a opção de download.
  • Quando a pré-visualização pode comprometer a segurança ou privacidade dos dados contidos no arquivo.

Uso

js
<CdsFileViewer
	variant="green"
	size="md"
	text="Lorem Ipsum"
	@click="fileViewerClick = true"
/>

Preview

jpeg
Comprovante de residência
https://images.pexels.com/photos/1254140/pexels-photo-1254140.jpeg
Mostrar log

Props

Nome
Tipo
Default
Opções
Descrição
* label (required)string'Comprovante de residência' -- Especifica a label do arquivo. A label deve ter no máximo 50 caracteres.
* fileUrl (required)string'https://images.pexels.com/photos/1254140/pexels-photo-1254140.jpeg' -- Especifica a URL do arquivo. A URL deve conter a extensão do arquivo para que a pre-visualização seja gerada.
variantstring'green'green
teal
blue
indigo
violet
pink
red
orange
amber
dark
Especifica a variante de cor do componente.

Eventos

Nome
Descrição
@closeEvento que indica que o backdrop foi fechado.
@download-clickEvento que indica que a ação de download foi acionada. O componente não implementa a lógica de download. A lógica deve ser implementada pelo desenvolvedor.

Última atualização:

Released under the Apache-2.0 License.