Lista

Tipo

Referência

Para

Analista

Na tela

DataViz › Aplicação › Dashboards › Editando Widget › Lista

Cada item da Lista é um valor de uma dimensão, como um vendedor ou uma filial, e clicar nele filtra o Dashboard. Funciona como um filtro sempre aberto dentro do layout, com busca, e pode trazer uma barra com o valor de cada item ao lado do nome.

A Lista sempre mostra todos os valores da dimensão, mesmo os que não estão selecionados, mas respeita os outros filtros do Dashboard: filtrar uma região reduz a lista de vendedores aos daquela região. Para o filtro do topo do Dashboard, veja Filtros. Nome e filtros do widget seguem as opções comuns.

Aba Dados

Na tela	O que faz
Campo de Dimensão	A dimensão cujos valores viram itens.
Ordenação	Alfabética (A-Z), Alfabética (Z-A), Numérica (crescente) ou Numérica (decrescente). A numérica ordena pelo valor do gráfico inline, e só funciona com Mostrar gráfico inline ligado e configurado.
Filtro	Restringe os itens só deste widget. Veja Filtros.
Limite de resultados	Com Quantidade máxima, quantos itens no máximo, segundo a Ordenação. Padrão 50.

Aba Visual

Layout

Na tela	O que faz
Orientação	Vertical ou Horizontal (os itens lado a lado, como botões).
Tipo de exibição	Coluna única ou Grid, com Número de colunas.
Exibir campo de busca	Só na orientação vertical. A busca procura entre os itens já carregados.
Modo de seleção	Clique simples ou Checkbox.
Modo compacto	Itens mais baixos.
Comportamento da Seleção	Seleção Única (clicar em outro item troca o filtro) ou Seleção Múltipla (os itens se somam no filtro). Clicar de novo num item selecionado tira ele do filtro.

Visualização de Valor

Na tela	O que faz
Mostrar gráfico inline	Pinta atrás de cada item uma barra proporcional a uma medida, escolhida em Campo de valor para o gráfico.
Cor do preenchimento	Cor Fixa ou Cor por Expressão. Com Opacidade do preenchimento (0 a 1) e Cor do texto sobre o gráfico.

Formatação, Alinhamento Vertical e Estilo dos Itens ajustam Tamanho da fonte (de Extra pequeno a Grande), Peso da Fonte (Normal ou Negrito), Estilo da Fonte (Normal ou Itálico), Alinhamento do texto, Tratamento de texto longo (Truncar ou Quebrar linha), Exibir valor do gráfico inline, borda, cantos, preenchimento interno e Efeitos ao passar o mouse. Alinhamento do conteúdo define se os itens começam no topo (Esticar (Topo)) ou ficam no meio do widget (Centralizar, com Largura do Conteúdo (quando Centralizado)).

Cores e Tema: Cor de fundo do Widget (Padrão (Tema), Transparente, Personalizada ou Expressão) e o Esquema de cores dos itens, com fundo e texto para Estado Normal, Estado Selecionado e Estado Hover (este só com Efeitos ao passar o mouse ligado). Coloração baseada em expressão colore cada item por uma regra.

Aba Avançado

Na tela	O que faz
Formatação condicional	Uma regra que devolve um objeto de estilos CSS para o item, como { backgroundColor: "red", fontWeight: "bold" }.
Botões de selecionar todos/limpar seleção	Só na seleção múltipla. Dois ícones no topo da lista, Selecionar Tudo e Limpar. Selecionar Tudo marca só os itens visíveis: com uma busca digitada, só o resultado dela. Limpar tira o filtro desta dimensão.
Mostrar itens sem valores (para gráfico inline)	Só aparece com gráfico inline e campo de valor escolhidos. Traz também os itens sem valor na medida.

Regras em JavaScript

Regra	Variáveis	Devolve
Colorir Gráfico Inline	this.value (a medida), this.row, this.index	Uma cor.
Colorir Itens	this.value (o item), this.row, this.isSelected, this.index	Uma cor de fundo, ou um objeto com background e color.
Formatação Condicional	this.value, this.row, this.isSelected, this.index	Um objeto de estilos CSS.
Colorir Fundo Widget (Cor de fundo do Widget = Expressão)	Nenhuma	Uma cor para o fundo do widget.

Todas recebem também this.datefns. Veja Regras em JavaScript. Exemplo em Colorir Itens, para destacar a matriz:

if (this.value === "Matriz") return { background: "#1e3a8a", color: "#ffffff" };
return null;

Limites

• Sem Limite de resultados, a Lista carrega até 10.000 itens.
• A Lista não tem Campos para Relatório: ela existe para filtrar.

Pelo Lumo CLI

Este widget também pode ser criado e versionado em YAML, com type: ListBox. Veja a referência de app.