Imagens e ficheiros

Cada dashboard tem uma área de anexos — o ícone do clipe na barra superior, ou /dashboard/<id>/assets. É onde se guardam logotipos, ícones, imagens de fundo e ficheiros para descarregar.

Carregar

Arraste os ficheiros para a área ou escolha-os. Cada anexo fica registado com o nome, o tipo e o tamanho.

Os anexos pertencem ao dashboard: acompanham-no quando se duplica ou exporta, e são apagados com ele. Não são partilhados entre dashboards — se precisar do mesmo logotipo em três dashboards, carregue-o nos três.

A referência do anexo

Cada anexo tem uma referência no formato asset:<identificador>, que se copia a partir da lista. É isso que se cola onde a imagem for precisa.

Usar num widget de imagem

O widget Imagem tem três fontes possíveis:

Fonte	O que se indica	Quando usar
URL	Um endereço na internet	Imagem alojada noutro sítio
Anexo	A referência asset:<id>	Logotipos e imagens do próprio dashboard
Campo	Um campo do conjunto de dados	Uma imagem diferente por linha

Com a fonte campo, é preciso dizer o que o campo contém:

• url — um endereço;
• path — uma referência a anexo;
• base64 — a própria imagem codificada nos dados.

O ajuste decide como a imagem preenche o espaço: cover corta o que sobra para preencher, contain mostra tudo deixando margens, fill deforma para encher.

Usar numa coluna de tabela

Uma coluna de tabela pode ser do tipo imagem ou ficheiro, com as mesmas três fontes. É como se põe uma miniatura de produto ao lado do nome, ou um link para a factura de cada linha.

Por omissão, a coluna lê o valor do próprio campo. Ver Tabelas.

Num dashboard público

Os anexos de um dashboard publicado são servidos a quem abre o link, sem sessão — mas apenas os daquele dashboard. Um anexo de outro dashboard não e alcançável a partir de um link público.

Boas práticas

Dimensione as imagens antes de carregar. Uma fotografia de 4 MB usada como logotipo de 120 px continua a ser transferida inteira por quem abre o dashboard.

Prefira anexos a endereços externos. Uma imagem alojada noutro sítio desaparece quando esse sítio muda, e num dashboard público pode simplesmente não carregar.

Formatos. PNG para logotipos e imagens com transparência, JPG para fotografias, SVG para ícones que precisem de escalar sem perder nitidez.