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
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. |
variant | string | 'green' | green teal blue indigo violet pink red orange amber dark | Especifica a variante de cor do componente. |
Eventos
Nome | Descrição |
---|---|
@close | Evento que indica que o backdrop foi fechado. |
@download-click | Evento 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. |