# Gráfico de barras

> Referência do componente de dashboard Gráfico de barras, a comparação categórica de pontos ao vivo, com todas as propriedades do editor.

O **Gráfico de barras** compara pontos ao vivo lado a lado: uma barra por endereço, lida neste
momento. É um gráfico categórico, não um gráfico de tempo: não há eixo de tempo, não há janela,
não há cadência de amostragem e não há retenção por trás dele. Para acompanhar pontos ao longo
do tempo, use o [Gráfico de linhas](component-line-chart).

Um ponto que não está lendo é deixado de fora da comparação em vez de ser desenhado em zero, e
o gráfico diz isso sob o desenho (`1 de 4 pontos não está lendo e fica de fora.`). Uma tela que
acabou de abrir ainda não diz nada: ainda não lido não é o mesmo que não está lendo.

## Conteúdo e pontos {#content-and-points}

| Propriedade | O que ela faz | Valores | Padrão |
|---|---|---|---|
| Título do gráfico | Cabeçalho opcional desenhado dentro do subgráfico. Este é o cabeçalho do próprio gráfico, não o título de canto do componente (aquele mora na seção Aparência compartilhada). | texto | vazio |
| Pontos | As categorias comparadas, um cartão por barra, na ordem declarada. Cada cartão guarda os três campos abaixo. **Adicionar ponto** junta um. | lista | vazio |
| · Endereço | Endereço com raiz, na Logic, que a barra lê. O campo sugere a partir da lista de pontos ao vivo, filtrada por pontos numéricos, e mostra a leitura atual do ponto assim que ele é nomeado. | endereço | vazio |
| · Nome | Como o eixo e a legenda chamam a barra. | texto | em branco recai no endereço |
| · Cor | A tinta da barra como `#RRGGBB`. | cor hex | em branco toma a vez da paleta |
| Ordem | A ordem em que as barras são desenhadas. A ordem declarada mantém uma estação onde o operador a pôs, seja o que for que ela produziu; ordenar responde quem lidera, em vez disso. | como declarado · do menor para o maior · do maior para o menor | como declarado |

## Formato {#format}

Uma declaração para o gráfico inteiro, nas barras, nas dicas de valor e nos rótulos igualmente, porque
um gráfico escreve um número de um jeito só.

| Propriedade | O que ela faz | Valores | Padrão |
|---|---|---|---|
| Unidade | Unidade de engenharia opcional escrita depois de cada leitura. | texto | vazio |
| Decimais | Casas decimais fixas para as leituras. | de 0 a 15 | em branco usa a preferência da estação |
| Lê-se como | Como cada leitura é escrita por extenso. O valor em si nunca é reescalado pela escolha. | Número · Porcentagem · Duração | Número |
| O valor conta | O que uma unidade do valor significa enquanto o formato é uma duração. Mostrado só nesse formato. | Segundos · Milissegundos · Minutos | Segundos |

## Barras {#bars}

| Propriedade | O que ela faz | Valores | Padrão |
|---|---|---|---|
| Deitar as barras | Desenha as barras na horizontal. Nomes longos se leem melhor deitados do que sob uma barra. Quando a célula é estreita demais para os nomes, as leituras e a escala lado a lado, ela cede espaço nesta ordem: um nome mais longo que a sua parte da largura termina em reticências, depois as leituras saem e depois os próprios nomes. A dica de valor sobre uma barra continua mostrando o nome inteiro e a leitura dela, e cada parte volta assim que a célula fica larga o bastante para ela. | ligado / desligado | desligado |
| Empilhar tudo em uma única barra | Empilha as categorias numa barra única em vez de pô-las lado a lado. Lado a lado responde "quanto cada uma fez"; empilhadas respondem "como o todo se divide", que é a pergunta da pizza desenhada de forma direta. | ligado / desligado | desligado |
| Escrever cada leitura na barra dela | Escreve o valor formatado em toda barra. Uma célula baixa demais para escrever as leituras sobre as barras em pé ou, com as barras deitadas, estreita demais para escrevê-las ao lado delas as deixa para a dica de valor. Uma leitura que seria escrita sobre a da vizinha também sai e fica para a dica de valor. | ligado / desligado | ligado |
| Mín | O piso em que o eixo de valor é mantido, na unidade das próprias leituras. Em branco deixa o eixo se reajustar ao que estiver sendo lido, o que põe a barra mais alta no topo do subgráfico seja o que for que ela mediu. Uma escala mantida é o que torna dois olhares comparáveis. | número | em branco (automático) |
| Máx | O teto em que o eixo de valor é mantido. As duas pontas são independentes: um piso pode ser mantido enquanto o teto acompanha os dados. | número | em branco (automático) |
| Legenda | Onde a legenda fica. Oferecida só enquanto as barras estão empilhadas: lado a lado, as barras já estão nomeadas no eixo e uma legenda imprimiria a mesma lista duas vezes; empilhadas numa coluna só, a legenda é a única coisa que consegue distinguir os segmentos. Uma célula estreita demais para escrever todos os nomes na única linha da legenda lista os segmentos um por linha: um nome mais longo que a sua linha termina em reticências e a dica de valor sobre a linha o mostra inteiro. A lista ocupa no máximo cinco linhas, e menos numa célula baixa demais para guardar também um terço da sua altura para o subgráfico: com mais segmentos que linhas, ela os mostra uma página por vez, com as setas e o contador de páginas (como 1/3) na última linha. A linha volta assim que a célula fica larga o bastante. | sobre o subgráfico · sob o subgráfico · nenhuma | sobre o subgráfico |

Uma célula pequena demais para tudo deixa partes de fora antes que o subgráfico fique pequeno
demais para ser lido. Numa célula baixa, as barras em pé lado a lado deixam de fora primeiro as
leituras sobre elas e depois os nomes sob elas, e as barras deitadas, lado a lado ou empilhadas,
deixam de fora os números da escala sob elas. Numa célula estreita, as barras em pé, lado a lado ou
empilhadas, deixam de fora os números da escala ao lado delas, e um nome sob uma barra que já não
cabe termina em reticências. A dica de valor sobre uma barra continua mostrando o nome e a leitura
dela, e cada parte volta assim que a célula tem espaço para ela.

## Faixas da escala {#scale-bands}

A seção **Escala** declara trechos da extensão de valores e o que cada um significa, pelo mesmo
editor de faixas que todo componente de visualização compartilha. Num gráfico de barras as
faixas são uma paleta: elas tingem as barras conforme onde cada leitura cai, e nada mais.
Várias leituras são comparadas de uma vez, então não existe um trecho único em que o desenho
*está*: as faixas não carregam campo de redação aqui e nenhuma marca de referência é oferecida.

Cada faixa cobre tudo até o limite dela, a partir de onde a faixa acima dela na lista terminou;
uma leitura além do último limite não pertence a faixa nenhuma e mantém a tinta escrita da
barra. O tom nomeia o significado, Neutro, Informação, Sucesso, Atenção, Crítico, e o tema em
vigor decide a tinta.

## Caixa de ferramentas {#toolbox}

A seção **Caixa de ferramentas** escolhe quais botões o operador recebe neste gráfico. Uma
comparação não tem eixo a percorrer, então só as ferramentas que ela consegue honrar são
oferecidas; sem nenhuma marcada, nenhuma barra de ferramentas é desenhada.

| Ferramenta | O que ela faz | No conjunto padrão |
|---|---|---|
| Salvar PNG | Baixa o desenho como um PNG. | sim |
| Copiar PNG | Põe o desenho na área de transferência como um PNG. | sim |
| Tela cheia | Preenche a janela com este gráfico. | sim |