Imagem

Visão geral

O componente Imagem carrega imagens (JPG, JPEG, PNG, GIF ou WebP) associadas a um registo e mostra-as diretamente na interface — em vez de as esconder atrás de uma ligação de transferência. É indicado para fotos de produtos, provas de trabalho, avatares e qualquer conteúdo visual que faça sentido ver de imediato numa tabela, num formulário ou num cartão de kanban.

O valor guardado é, byte a byte, o mesmo do componente Ficheiro — o mesmo JSON de metadados e o mesmo bucket de armazenamento (attachments). Trocar o tipo de uma coluna entre Ficheiro e Imagem preserva os dados já carregados; o que a configuração da Imagem controla é só a apresentação por contexto (formulário, tabela, kanban), nunca o formato do valor.

Configuração

Definição	Descrição
Default	Modo de apresentação usado em qualquer contexto sem escolha própria: Inline (predefinição) ou Botão + dialog.
Tabela	Miniaturas compactas na célula (Inline) ou um botão que abre o visualizador (Botão + dialog).
Formulário	Galeria de miniaturas visível (Inline) ou um botão que abre o visualizador (Botão + dialog).
Kanban	Aplica-se também a kiosk, POS e cartões — uma única definição para as quatro superfícies. Inline mostra a imagem no corpo do cartão; Botão + dialog mostra um chip "Ver imagem". Só na vista Kanban a imagem em modo Inline pode ainda ser promovida a capa (ver Apresentação nas vistas).
Permitir várias imagens	Aceita mais do que uma imagem na mesma coluna. Desligado (predefinição) guarda uma imagem única; ligado guarda uma lista.
Máximo de imagens	Só aparece com "Permitir várias imagens" ligado. Limite de imagens na coluna; vazio = sem limite.
Tamanho máximo (MB)	Tamanho máximo aceite por imagem; vazio = sem limite de tamanho.
Subpasta de armazenamento	Subpasta de destino dentro do caminho feature_X/column_Y/ no bucket de anexos; o texto introduzido é convertido num slug seguro.
Formatos aceites	Fixo, não configurável: jpg, jpeg, png, gif, webp.

Interação

Carregar uma imagem abre o seletor de ficheiros restrito aos formatos aceites; cada imagem escolhida é enviada de imediato, uma de cada vez — se uma imagem de um lote falhar a meio, as anteriores já carregadas ficam guardadas.

Numa galeria editável, tocar no X vermelho no canto de uma miniatura remove essa imagem.

Tocar em qualquer imagem — na galeria do formulário, nas miniaturas da tabela ou na imagem do cartão — abre o visualizador em diálogo: ampliar com pinça/scroll (até 5x), navegar entre imagens com as setas (ecrãs largos) ou por gesto, e um indicador "X de N" quando há mais do que uma imagem. O visualizador está sempre disponível, mesmo em vistas só de leitura.

Ao atingir o "Máximo de imagens", o botão de carregar deixa de aparecer; escolher mais imagens do que o espaço restante corta o excesso e mostra um aviso. Uma imagem acima do "Tamanho máximo (MB)" é ignorada no carregamento, também com aviso.

Apresentação nas vistas

Vista	Apresentação
Formulário / vista default	Inline: galeria de miniaturas com botão para carregar mais; Botão + dialog: botão "Ver imagem(ns)"
Tabela / Lista / Calendário	Inline: até 3 miniaturas em linha, com badge "+N" para as restantes; Botão + dialog: ícone que abre o visualizador
Kanban	Inline: imagem grande no cartão, promovida a capa quando é a primeira coluna de imagem elegível (ver abaixo); Botão + dialog: chip "Ver imagem(ns)"
Kiosk / POS / Cartões / Execução	Inline: imagem grande no corpo do cartão, sem promoção a capa; Botão + dialog: chip "Ver imagem(ns)"

O Calendário e a vista de Execução usam, respetivamente, a mesma superfície compacta da Tabela e a mesma superfície de cartão do Kanban, mas nenhum dos dois segue as definições Tabela ou Kanban — ambos seguem sempre o modo Default.

A promoção a capa é exclusiva da vista Kanban. Nela, uma coluna de imagem em modo Inline que seja a primeira coluna elegível entre os campos mostrados no cartão sai do corpo e passa a capa: uma banda de imagem a toda a largura no topo do cartão, ao estilo Trello. Só a primeira coluna nessas condições é promovida (um cartão tem uma única capa); as restantes colunas de imagem ficam no corpo, como qualquer outro campo. Uma coluna em modo Botão + dialog nunca é promovida a capa, e um registo sem imagem carregada não deixa uma banda vazia.

Em kiosk, POS e cartões, o modo Inline mostra a mesma banda de imagem dentro do corpo do cartão, mas sem a promoção a capa edge-to-edge — essas superfícies partilham o modo de apresentação com o Kanban (via a mesma definição), não o comportamento de capa. Um separador de kiosk configurado para mostrar uma vista Kanban herda o comportamento real de capa, por ser Kanban e não a superfície de kiosk propriamente dita.

Este componente não é filtrável nas vistas.