Pular para o conteúdo principal

Preview

O componente Preview permite a exibição de dados em modo somente leitura, renderizando uma tabela paginada a partir de uma consulta SQL ou Json Array.

Componente Preview

Observações:

  1. O componente não permite edição dos dados.
  2. A paginação e a busca textual são realizadas no servidor (SQL) ou em memória (JSON), dependendo da fonte de dados configurada.
  3. Colunas binárias (imagens) são detectadas automaticamente e exibidas como miniaturas.

Demonstração:


Propriedades em comum:

PropriedadeDescriçãoTipoExemplo
AlturaDefine a altura do componente.Inteiro400
CódigoInforma o código gerado pelo Maker ao qual o componente/formulário foi associado. De forma geral, não interfere nas características do componente.Inteiro5
ContainerInforma em qual container o componente irá ser inserido.Indefinido
DicaArmazena uma dica para o componente, o qual se torna acessível no modo de inserção ou alteração.Letras"Informações relativas à 02/2026"
HabilitadoTorna o componente possível de ser manipulado. Quando desabilitado, aplica opacidade reduzida e bloqueia interações.LógicoSim
NomeApresenta o nome do componente. O Maker sugere um nome diferente dos nomes dos componentes existentes no formulário para evitar duplicidade.Letras"PreviewPedidos"
Posição X e Posição YO "X" determina a posição do componente em relação à esquerda do formulário, e o "Y" em relação ao topo.Inteiro100
TamanhoDetermina a largura do componente.Inteiro800
VisívelSelecionando a opção Sim, o componente aparece no formulário.LógicoSim
SQLConsulta SQL que alimenta o componente. Pode conter parâmetros dinâmicos do formulário pai no formato {campo}. Quando preenchida, tem prioridade sobre a propriedade Dados JSON.SQLSELECT COD, NOME FROM CLIENTES WHERE EMP = {empresa}
Fonte de DadosFonte de dados configurada no projeto a ser usada para executar a consulta SQL.ConexãoConexão Principal
PaginaçãoNúmero de registros exibidos por página.Inteiro10

Propriedades específicas do componente Preview:

PropriedadeDescriçãoTipoExemplo
Ativar PesquisaExibe o campo de busca textual no cabeçalho do componente. A busca percorre todas as colunas de texto simultaneamente.LógicoSim
Altura da LinhaAltura de cada linha da tabela em pixels.Inteiro44
Exibir ImagensQuando habilitado, colunas binárias são renderizadas como imagens em miniatura. Quando desabilitado, essas colunas são ocultadas.LógicoSim
Mensagem Quando VaziaMensagem exibida na área da tabela quando não há registros para mostrar.Letras"Nenhum registro encontrado."
Dados JSONString JSON com um array de objetos para carregar dados diretamente no componente, sem SQL. As chaves do primeiro objeto definem os cabeçalhos das colunas.Texto[{"Nome":"João","Cargo":"Dev"}]

Fontes de dados

O Preview detecta automaticamente a fonte de dados a utilizar:

  1. SQL (server-side) : quando a propriedade SQL está preenchida. Paginação e busca são realizadas no servidor. Recomendado para consulta de dados dinâmicos.
  2. JSON (client-side) : quando a propriedade Dados JSON está preenchida com um array JSON. Paginação e busca são realizadas em memória.

Exemplo de JSON:

[
{"nome":"Caua Lima S. de Andrade","email":"[email protected]","vaga":"Desenvolvedor Maker NoCode","localizacao":"F1 - Analise","data":"18/02/2026"},
{"nome":"Caua Lima S. de Andrade","email":"[email protected]","vaga":"Desenvolvedor Maker NoCode","localizacao":"F1 - Analise","data":"18/02/2026"},
{"nome":"Eduardo Pereira Rocha","email":"[email protected]","vaga":"Desenvolvedor de Sites","localizacao":"F1 - Analise","data":"28/01/2026"},
{"nome":"Eduardo Pereira Rocha","email":"[email protected]","vaga":"Desenvolvedor Python","localizacao":"F1 - Analise","data":"28/01/2026"},
{"nome":"Roberto Carlos","email":"[email protected]","vaga":"Desenvolvedor Python","localizacao":"F2 - Entrevista","data":"28/01/2026"},
{"nome":"Eduardo Pereira Rocha","email":"[email protected]","vaga":"Desenvolvedor Python","localizacao":"F1 - Analise","data":"28/01/2026"},
{"nome":"Beatriz Oliveira Santos","email":"[email protected]","vaga":"Desenvolvedor Python","localizacao":"F1 - Analise","data":"28/01/2026"},
{"nome":"Ana Carolina Mendes","email":"[email protected]","vaga":"Analista de Dados","localizacao":"F3 - Aprovado","data":"15/02/2026"},
{"nome":"Lucas Ferreira Lima","email":"[email protected]","vaga":"DevOps Engineer","localizacao":"F1 - Analise","data":"10/02/2026"},
{"nome":"Mariana Costa Silva","email":"[email protected]","vaga":"UX Designer","localizacao":"F2 - Entrevista","data":"20/02/2026"}
]

A propriedade SQL tem prioridade sobre Dados JSON quando ambas estão preenchidas.


Busca textual

Quando Ativar Pesquisa está habilitado, um campo de busca é exibido no cabeçalho.

  • É feita uma busca unificada utilizando as colunas visiveis no componente.
  • Colunas binárias (imagens) são ignoradas na busca.
  • Um badge exibe o total de registros encontrados.
  • O botão [X] limpa a busca e restaura os dados originais.

Paginação

O rodapé exibe os controles de navegação:

  • Seletor de tamanho de página: opções 5, 10, 15, 25, 50 e 100 registros por página.
  • Indicador de página: exibe a página atual e o total (ex: 1 / 10).
  • Campo "Ir para": aparece automaticamente quando o total de páginas for maior que 5.
  • Botões de navegação: primeira, anterior, próxima e última página, com botões numéricos ao redor da página atual.