# Progresso

> Referência do componente de dashboard Progresso, uma leitura limitada como barra, como barra segmentada ou numa escala com faixas, com todas as propriedades do editor.

O componente **Progresso** desenha uma leitura numérica limitada ao longo de uma trilha. As
três apresentações dele respondem a perguntas diferentes sobre o mesmo valor: quanto da
extensão foi tomado, quantos passos dela foram tomados, e em que trecho declarado a leitura
está. É por isso que elas são uma escolha, e não um estilo. Uma trilha sem leitura não
desenha preenchimento nenhum (uma barra vazia se leria como um zero medido) e mostra a marca
de lacuna (`—`) onde vai o número. `NaN` é uma leitura, não uma lacuna: essa palavra é escrita
ao lado da unidade sobre uma trilha vazia, já que `NaN` não tem lugar na escala.

## Conteúdo e dados {#content-and-data}

| Propriedade | O que ela faz | Valores | Padrão |
|---|---|---|---|
| Rótulo | Legenda opcional acima da trilha. Um rótulo longo é cortado com reticências, com ele inteiro na dica, e nunca toma espaço da leitura. | texto | vazio |
| Endereço | Endereço com raiz, na Logic, do ponto numérico mostrado. 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 |

## Formato {#format}

| Propriedade | O que ela faz | Valores | Padrão |
|---|---|---|---|
| Mín | Onde a escala começa, na unidade de engenharia do ponto. | número | 0 |
| Máx | Onde a escala termina. Abaixo do Mín não há escala em que assentar uma leitura. | número | 100 |
| Unidade | Sufixo de unidade opcional ao lado da leitura. | texto | vazio |
| Decimais | Casas decimais fixas para o mostrador. Em branco, um ponto cujo tipo é um número inteiro é escrito sem fração, e qualquer outro número nas casas da estação. Com o campo em branco, a referência e os extremos da escala seguem as casas do ponto, como a leitura: nenhuma num número inteiro, as da estação em qualquer outro. | de 0 a 15 | em branco usa a preferência da estação |
| Dígitos | Quantas casas a leitura reserva antes do separador decimal; uma leitura que passa disso é marcada (`####`) com ela inteira na dica. Um ponto que responde em palavras (uma ordem, um lote, um sinalizador) nunca ganha essa marca: o que o campo não comporta termina em reticências (…), com a leitura inteira na dica. | de 1 a 20 | em branco deriva do maior entre Mín e Máx |
| Tamanho da fonte | Se a célula decide o tamanho do texto ou se o operador o declara. | Tão grande quanto a célula permitir · Um tamanho que eu defino | Tão grande quanto a célula permitir |
| Pontos | O tamanho declarado. Mostrado só no modo declarado. | de 9 a 144 | 12 |
| Lê-se como | Como a leitura é escrita por extenso. | Número · Porcentagem · Duração | Número |
| O valor conta | O que uma unidade do valor significa enquanto o formato é uma duração. | Segundos · Milissegundos · Minutos | Segundos |
| Escrever a leitura | Se a leitura é escrita ao lado da trilha. | ligado / desligado | ligado |
| Escrever os extremos da escala | Se os dois extremos são escritos sob a trilha. | ligado / desligado | desligado |

## Barra {#track}

| Propriedade | O que ela faz | Valores | Padrão |
|---|---|---|---|
| Desenha | A apresentação: um preenchimento contínuo do começo da escala até a leitura; o mesmo preenchimento cortado em células iguais, acesas até a leitura (uma barra segmentada); ou as faixas declaradas pintadas ao longo da trilha, com a leitura cavalgando nelas como uma marca, sem nada preenchendo, porque a pergunta é onde na escala o valor está, não quanto dela foi usado. | Uma barra preenchida até a leitura · Degraus acesos até a leitura · As faixas, com a leitura marcada nelas | Uma barra preenchida até a leitura |
| Sentido | Para que lado a trilha corre: na largura da célula, com a escala começando na borda esquerda, ou na altura da célula, com a escala começando embaixo, uma coluna de nível. | Na largura da célula · Na altura da célula | Na largura da célula |
| Células | Em quantas células uma trilha em degraus é cortada. Pedido só por essa apresentação. | de 2 a 50 | 10 |
| A escala começa no extremo oposto | Inverte a direção da escala, então o preenchimento cresce de volta em direção à ponta próxima. É só a direção, nunca um segundo par de pontas: o Mín continua sendo o mínimo. | ligado / desligado | desligado |
| Destaque | De onde vem a cor do preenchimento. Identidade, não significado: as faixas mantêm a última palavra sobre o significado da leitura. | A tinta comum · Uma cor · Um ponto de cor | A tinta comum |
| Claro / Escuro | O destaque como um par claro e escuro, os dois declarados porque o tema em vigor decide qual metade está na tela. Mostrado só enquanto o destaque é uma cor. | `#RRGGBB` cada | `#5470C6` os dois |
| Ponto de cor | Endereço com raiz, na Logic, de um ponto de Cor que o destaque segue. Mostrado só enquanto o destaque é um ponto de cor. | endereço | vazio |

## Escala {#scale}

A seção **Escala** compartilhada declara as faixas e a referência.

- Cada **faixa** cobre tudo até o limite dela, a partir de onde a faixa acima terminou; uma
  leitura além do último limite não pertence a faixa nenhuma. O tom (Neutro, Informação,
  Sucesso, Atenção, Crítico) tinge a leitura escrita e, na apresentação em faixas, as faixas
  são a própria trilha, pintadas esteja o ponto respondendo ou não: elas são a declaração,
  não a medição. Uma faixa redigida escreve o nome dela no topo, antes do número, para que a
  leitura fique com o fim da linha.
- A **referência** marca um setpoint ou um nominal na trilha: nada, um valor fixo, ou um
  ponto que se move com a receita. A dica da marca carrega o valor da referência, e ela é
  desenhada só enquanto a escala a alcança.