Barras e linhas

Tipo

Referência

Para

Analista

Na tela

DataViz › Aplicação › Dashboards › Editando Widget › Barras, Colunas ou Linhas

O widget de barras e linhas compara valores entre categorias ou ao longo do tempo: vendas por vendedor, faturamento mês a mês, receita contra meta. No catálogo de widgets ele aparece três vezes, como Barras, Colunas e Linhas: é o mesmo widget, que nasce com outro tipo e outra orientação, e qualquer um deles vira o outro em Tipo do Gráfico (aba Dados) e Orientação (aba Visual).

Uma série pode ser barra e outra linha no mesmo gráfico, cada uma no seu eixo. Nome, aparência, filtros e Campos para Relatório seguem as opções comuns.

Aba Dados

Na tela	O que faz
Tipo do Gráfico	Barras, Linhas, Área ou Radar. Vale para todas as séries, salvo as que tiverem tipo próprio.
Dimensões	O eixo das categorias, como Mês ou Vendedor. Até 2, e a segunda só com um valor. Com 2 dimensões, a engrenagem abre a cor de cada série.
Valores	As medidas, uma série cada. Com 2 dimensões, só um. A engrenagem abre a configuração da série.
Dimensões Alternativas	Outras dimensões para o eixo. O uso delas depende de Dimensões Alternativas na aba Comportamento.
Valores Alternativos	Aparece com um valor só. Outras medidas que quem vê o Dashboard põe no lugar da série, num seletor no gráfico, como Vendas por Lucro.
Filtros	Restringe só este widget. Veja Filtros.
Ordenação	Pode ser uma coluna que não aparece no gráfico, como ordenar o nome do mês pelo número do mês. Se a coluna for mais detalhada que as dimensões, a tela avisa que os registros podem duplicar.

O que entra em Dimensões e Valores muda o desenho:

Montagem	Resultado
1 dimensão e 1 ou mais valores	Uma barra ou ponto por categoria e por valor, lado a lado.
2 dimensões e 1 valor	A primeira dimensão fica no eixo e a segunda vira séries, uma cor por valor. Vendas por ano, uma série por estado.
Nenhuma dimensão e 2 ou mais valores	Uma barra por medida, para comparar totais.

Configuração da série

Na tela	O que faz
Tipo de Coloração	Cor Fixa ou Cor por Expressão.
Escala	O eixo vertical da série: 1, 2 ou 3. Use outro eixo para medidas de grandeza diferente, como faturamento em reais e margem em percentual.
Tipo de Gráfico	Barra, Linha ou Área, só para esta série.
Rótulo desta série	Herdar do gráfico, Sempre mostrar ou Nunca mostrar o valor sobre os dados. Herdar do gráfico segue Mostrar valores sobre os dados da aba Visual.
Formato do Número	Aparece com Sempre mostrar. Formata o valor escrito sobre os dados desta série. Veja Formato do Número.
Mostrar percentual do total	Aparece com Sempre mostrar. Junta ao valor a participação do ponto no total da série, como "R$ 12.000 (37,7%)". Se a série tem algum valor negativo, o percentual não aparece.
Acumular Valores	Cada ponto soma os anteriores: o total acumulado do ano mês a mês. A soma é simples, então percentual e média acumulados não fazem sentido.

Cor de cada série

Com 2 dimensões, cada valor da segunda vira uma série, e a engrenagem das dimensões abre Configuração dos Eixos para pintar essas séries. Cor por Valor dá uma cor a cada valor da segunda dimensão (Aprovado verde, Reprovado vermelho), com a lista descrita em Cor por valor; Carregar Valores da Aplicação traz até 50 valores. Cor por Expressão usa uma regra em JavaScript.

Aba Visual

Na tela	O que faz
Aparência	Padrão, Transparente ou Destacado, com Cor do fundo. Veja Aparência.
Cor do valor sobre os dados	A cor dos números desenhados no gráfico.
Orientação	Com o tipo Barras. Vertical põe as categorias no eixo vertical, com as barras deitadas (é como nasce o widget Barras do catálogo). Horizontal põe as categorias embaixo, com as barras em pé (o widget Colunas).
Barras Empilhadas, Área Empilhada	Com o tipo Barras ou Área. Uma série em cima da outra. Empilhamento Relativo estica cada pilha até 100%, para ver participação.
Largura da Barra	Com o tipo Barras. Automático ou Personalizado, com Largura Máxima em pixels. Evita barras largas demais quando há poucas categorias.
Mostrar valores sobre os dados	O padrão das séries, que cada uma pode trocar em Rótulo desta série. Com ele: Estilo do valor sobre os dados (tamanho, negrito, itálico) e, com barras empilhadas, Mostrar valores sobre os dados para cada barra (o valor de cada pedaço da pilha) e Mostrar valores sobre o total empilhado (a soma no topo).
Mostrar legenda	Com Posição da Legenda: Inferior ou Superior.
Apresentar linhas de grade verticais, Apresentar linhas de grade horizontais, Apresentar pontos de marcações, Mostrar Escala	Liga ou desliga grade, pontos na linha e números do eixo.
Não mostrar valores zerados	Esconde os pontos com valor zero.
Limitar Registros	Com Máximo Registros (de 1 a 500), quantas linhas a consulta traz, como os 10 maiores clientes.

Aba Comportamento

Na tela	O que faz
Dimensões Alternativas	Como usar as dimensões alternativas da aba Dados: Escolha do Usuário ou Drilldown Hierárquico. Veja abaixo.
Completar períodos sem dados	Aparece quando a primeira dimensão é data. Desenha os dias ou meses sem venda com zero, para a linha do tempo não pular.
Campos para Relatório	Veja Campos para Relatório.
Mostrar itens sem valores	Traz também as categorias sem valor na medida, como o produto que não vendeu no mês.

Dimensões Alternativas	O que acontece
Escolha do Usuário	Aparece um seletor no gráfico, e quem vê troca a dimensão do eixo, de Loja para Vendedor.
Drilldown Hierárquico	O gráfico desce um nível quando o Dashboard recebe um filtro na dimensão atual. Com Ano na dimensão e Mês, Dia nas alternativas, filtrar 2026 (clicando na barra ou no filtro do topo) mostra os meses de 2026.

Regras em JavaScript

As duas regras de cor recebem, além de this.datefns:

Regra	Variáveis
Colorir Valor (cor da série por ponto)	this.value (o valor do ponto), this.index (a posição), this.axis (a categoria do ponto), this.result (todas as linhas consultadas)
Colorir Eixo (cor de cada série, com 2 dimensões)	this.name e this.axis (a série), this.data (os pontos da série), this.index, this.result

Exemplo em Colorir Valor, para destacar os meses abaixo de R$ 50.000:

if (this.value < 50000) return "#dc2626";
return "#2563eb";

Limites

• Sem Limitar Registros, o gráfico traz até 100 categorias com uma dimensão e até 10.000 linhas com duas.
• No tipo Radar, todas as séries são radar: não dá para misturar com barra.
• Completar períodos sem dados não age quando o eixo tem mais de 100 categorias.
• Posição do valor sobre os Dados aparece com os valores ligados, mas hoje não muda o desenho.
• Porcentagem no formato do número multiplica por 100 duas vezes neste widget. Veja o aviso em Formato do Número.

Pelo Lumo CLI

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