Bloco Histograma
Agrupamento automático de valores brutos em faixas legíveis — forneça números individuais, não buckets pré-contados, e ele calcula a distribuição para você.
Como funciona
Diferente de todo gráfico irmão nessa família, um histograma não tem forma alguma de autoria por categoria ou série. A lista de linhas é uma única coluna de Valor com números brutos, um por linha — a nota de uma prova por aluno, o total de um pedido por transação, um tempo de resposta por solicitação. O agrupamento em faixas acontece no momento da renderização, não no momento da autoria: você nunca digita uma faixa ou uma contagem você mesmo. Uma vez agrupado, um histograma é desenhado e renderizado exatamente como um gráfico de barras de série única — ele reutiliza internamente o próprio pipeline de rasterização do gráfico de barras. Assim, ele herda o mesmo contrato de PNG renderizado mais tabela de dados sempre visível que todo gráfico dessa família assume: a imagem nunca é o único lugar onde as contagens de bucket residem.
Você controla aproximadamente quantas faixas mirar através de Número de faixas (2–20). O bloco divide o intervalo do mínimo ao máximo dos seus dados nesse número de buckets de largura igual e conta quantos valores autorados caem em cada um. Se todo valor que você digitou for idêntico, o intervalo é zero e não há nada para dividir. Em vez de desenhar o número de faixas solicitado como uma barra real e o restante como vazias, o histograma colapsa para uma única faixa contendo todos os valores. Uma distribuição com exatamente um valor distinto é inerentemente uma barra, não N-1 buckets vazios ao seu redor.
A tabela de dados abaixo da imagem lista o intervalo exato de cada faixa (formatado como "início–fim") junto com sua contagem. É o único lugar para ler os limites exatos dos buckets junto com as contagens — a imagem comunica a forma da distribuição num relance, mas não rotula cada barra conforme o número de faixas se aproxima do topo do intervalo.
Células em branco ou não numéricas na coluna Valor são descartadas antes do agrupamento (uma célula vazia não é um zero real); até 500 valores autorados são lidos, generoso para qualquer coisa digitada à mão.
Este bloco é apenas linhas autoradas — não tem modo de vínculo a fonte de dados ou a respostas de campanha. Veja Vinculando gráficos a dados reais para saber quais quatro tipos de gráfico suportam vínculo.
Campos configuráveis:
- Título do gráfico — mostrado acima da imagem.
- Valores — a lista de linhas, uma única coluna de Valor, um número bruto por linha.
- Número de faixas — de 2 a 20, quantos buckets de largura igual mirar.
- Cor da barra — sobrepõe a cor padrão da paleta para toda faixa.
- Cor de fundo, espaçamento interno, borda, raio da borda no cartão.
- Pares independentes de cor/tamanho de fonte para o título e o texto da legenda/tabela.
Exemplos
Subject
This week's order value spread
Um resumo de resultados de quiz pode montar um histograma com a nota bruta de cada aluno em 100, mostrando imediatamente se a turma se concentrou em torno de uma nota de aprovação ou se dividiu em dois grupos. Um relatório de operações de suporte pode fazer um histograma dos tempos de resposta em minutos entre os tickets da semana, deixando claro num relance se a maioria dos tickets fecha rápido com uma cauda longa de exceções, ou se concentra perto de um limite de SLA. Um recapitulativo de e-commerce pode fazer um histograma dos valores dos pedidos para ver as faixas de preço naturais em que os clientes estão comprando, sem decidir de antemão quais deveriam ser essas faixas — o bloco calcula isso a partir dos totais brutos por conta própria.
Como é o fallback estático
<div style="margin:12px 0;padding:16px;background-color:#ffffff;border-radius:8px">
<p style="margin:0 0 8px;font-weight:600;font-size:15px;color:#111827">Quiz scores</p>
<img src="https://mailinapp.com/api/analytics/chart?d=eyJ0eXBlIjoi...&s=3f9a2b1c..." width="560" height="280"
alt="Histogram: 60–68: 3, 68–76: 5, 76–84: 9, 84–92: 7, 92–100: 4"
style="display:block;max-width:100%;height:auto;margin:8px 0" />
<table style="width:100%;border-collapse:collapse;margin-top:4px">
<tr>
<th style="text-align:left;padding:4px 8px;font-weight:600;font-size:12px;color:#6b7280">Category</th>
<th style="text-align:left;padding:4px 8px;font-weight:600;font-size:12px;color:#6b7280">Count</th>
</tr>
<tr>
<td style="text-align:left;padding:4px 8px;font-size:12px;color:#6b7280">76–84</td>
<td style="text-align:left;padding:4px 8px;font-size:12px;color:#6b7280">9</td>
</tr>
</table>
</div>
O intervalo e a contagem exatos de cada faixa são uma linha de tabela simples — os mesmos números que o texto alt resume e que as barras visualizam.