# Rótulo

> Texto fixo na tela: tamanho, alinhamento, peso, inclinação e tinta, tudo declarado por você.

**Rótulo** é a escrita da tela: um título de tela, uma legenda sob um símbolo, o cabeçalho
de um grupo. É o único componente cuja configuração inteira é como o texto dele é
desenhado: nada nele é um endereço, ele não lê ponto nenhum, e nunca ganha a marca de
leitura ruim nem a de trava. É um componente de *Exibição*; um novo ocupa 4 × 1 células.

Como um Valor, um LED, uma Entrada ou um controle deslizante de propósito não desenham
legenda própria, o Rótulo é como você nomeia as coisas num dashboard: ponha um ao lado do
componente que ele descreve, onde você quiser.

## Conteúdo {#content}

| Campo | O que ele faz | Valores | Padrão |
|---|---|---|---|
| Texto | O texto mostrado no dashboard. Ele também é a declaração por trás do tamanho automático do texto: reescrever as palavras muda a largura sob a qual o tamanho é mantido. | Texto livre | `Label` |

## Tipo {#type}

Como a escrita é desenhada. Esta seção é do próprio Rótulo; como a *caixa* do componente
fica (moldura, preenchimento, título de canto, escala do conteúdo) é a [seção Aparência
compartilhada](components#the-shared-property-sections).

| Campo | O que ele faz | Valores | Padrão |
|---|---|---|---|
| Tamanho da fonte | Se a célula decide o tamanho do texto ou se você o declara. Um tamanho declarado é o que faz as legendas de uma tela concordarem: ajustada, cada uma é dimensionada pela célula dela e não saem duas iguais. | `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, e literal: a célula e a escala do conteúdo não o mudam mais. O texto que a célula não comporta é cortado, com ele inteiro na dica. Um tamanho fora da faixa é tomado na borda mais próxima e o painel diz isso. | de 9 a 144 pontos | 12 |
| Na horizontal | Para que lado as palavras são compostas dentro da célula. | `Esquerda` · `Centralizado` · `Direita` | `Esquerda` |
| Na vertical | Onde a linha fica entre o topo e a base da célula. Numa célula baixa demais para a linha, o texto pende do topo e continua legível, em vez de ser cortado nas duas pontas. | `Topo` · `Meio` · `Base` | `Meio` |
| Negrito | Desenha o texto no peso negrito. | ligado / desligado | desligado |
| Itálico | Inclina o texto. | ligado / desligado | desligado |
| Tinta | De onde o texto tira a cor. A tinta da própria interface já responde ao tema em vigor; uma cor sua é um par, uma metade por tema. | `A tinta da interface` · `Uma cor` | `A tinta da interface` |
| Claro / Escuro | O par de tinta, mostrado só quando **Tinta** é `Uma cor`. As duas metades ficam na tela ao mesmo tempo porque o tema em vigor decide qual delas pinta: uma cor só quebraria em silêncio o tema em que ela não foi escolhida. Cada metade é uma amostra mais um campo de hex (`#RRGGBB`); um hex digitado pela metade é recusado e o campo volta à cor em vigor. | `#RRGGBB` cada | `#1A1A1A` claro · `#F3F3F3` escuro |

## Corte {#truncation}

A regra vale nos dois modos de tamanho: o que a célula não comporta é cortado com
reticências, e o texto inteiro fica na dica. No modo automático o tamanho é limitado pela
largura que as palavras escritas reservam, contada por caractere, então um `i` e um `W` não
custam a mesma coisa, e é por isso que duas células do mesmo tamanho com as mesmas palavras
sempre as desenham no mesmo tamanho.

As seções compartilhadas Aparência, Identificação, Posição e camada e Ações estão descritas
na [página de componentes](components#the-shared-property-sections).