# Ícone

> Uma marca da biblioteca de ícones do aplicativo, numa cor e num tamanho escolhidos, opcionalmente conduzida por variáveis da Logic.

**Ícone** desenha uma marca da biblioteca de ícones do aplicativo, cerca de 2.770 glifos
nomeados, o mesmo conjunto de que a face do Botão, os estados do LED e as marcas das telas
escolhem, ou um dos ícones que você mesmo importou como recurso. A marca pode ser fixa, ou
qualquer um dos dois slots dela (o glifo e a cor) pode seguir uma variável da Logic, de modo
que um símbolo de válvula alterne entre marcas ou um indicador troque de cor conforme a
planta se move. É um componente de *Mídia*; um novo ocupa 2 × 2 células.

## Conteúdo {#content}

| Campo | O que ele faz | Valores | Padrão |
|---|---|---|---|
| Ícone (busca por nome ou tag) | Estreita a grade de glifos abaixo pelos nomes da biblioteca e pelas palavras-chave de busca curadas ("em inglês: wifi, save, warning…"). Todo seletor do aplicativo busca na biblioteca do mesmo jeito, então uma marca encontrada num deles é encontrada em todos. | Texto livre | vazio |
| A grade de glifos | O glifo padrão, escolhido ao pressionar uma célula. Mostrado de forma fixa, e o recurso de reserva sempre que a variável vinculada não resolve nada. | Qualquer glifo da biblioteca | o glifo Estrela |

Um *recurso* de ícone que você importou (um SVG de caminho único em Logic ▸ Assets ▸ Icons)
também pode ocupar o slot do glifo: ele é desenhado na mesma caixa, no mesmo tamanho
declarado, e recebe a mesma tinta onde herda cor; um desenho que se pinta sozinho mantém as
cores dele.

## Dados {#data}

Os dois vínculos se confirmam no painel como aquilo que representam, a marca atual da
variável vinculada desenhada na fonte da estação, a cor vinculada pintada ao lado do hex
dela, porque um ponto de código escrito por extenso é um quadradinho vazio e um hex é uma
palavra que ninguém consegue imaginar.

| Campo | O que ele faz | Valores | Padrão |
|---|---|---|---|
| Glifo da variável Ícone | Um endereço com raiz de uma variável da Logic com saída Ícone. A lista nomeia cada uma pelo nome ou, arquivada numa pasta, pelas pastas e pelo nome (Oven / Mark), e guarda o endereço com essas pastas (`Variables.Oven.Mark`). Vinculado, o slot do glifo segue a marca em que a variável resolver: a lógica de valor para ícone mora na variável, não aqui (veja a [página da Logic](logic)). `(nenhum)` limpa o vínculo e devolve o slot ao glifo fixo. | Uma variável Ícone, ou `(nenhum)` | `(nenhum)` |
| Cor da variável Cor | Um endereço com raiz de uma variável da Logic com saída Cor, conduzindo o slot de cor do mesmo jeito. Independente do slot do glifo, então um glifo fixo pode receber uma cor conduzida pela lógica, e vice-versa. | Uma variável Cor, ou `(nenhum)` | `(nenhum)` |

Um slot vinculado que não consegue ler (endereço não resolvido, ou qualidade ruim) mantém o
padrão configurado em vez de desenhar o valor velho da variável, e o componente ganha a marca
compartilhada de leitura ruim. Uma cor vinculada é validada como tinta segura antes de chegar
à tela; um texto que não é cor nenhuma deixa a cor configurada em vigor.

## Cor e tamanho {#color-and-size}

| Campo | O que ele faz | Valores | Padrão |
|---|---|---|---|
| Cor | A tinta do glifo como uma cor hex. Vazio segue o primeiro plano do próprio tema, que já responde ao claro e ao escuro. | `#RRGGBB`, ou vazio | vazio (tema) |
| Tamanho | O tamanho do glifo em pixels independentes de dispositivo. O mesmo número dimensiona a caixa de um recurso SVG, então os dois tipos de marca respondem ao campo do mesmo jeito. | Qualquer número | 40 |

## Avançado {#advanced}

| Campo | O que ele faz | Valores | Padrão |
|---|---|---|---|
| Código do glifo (avançado) | A cadeia bruta do glifo por trás do seletor, para colar um ponto de código direto. | Texto bruto | o glifo escolhido |

O Ícone é um componente de exibição: ele não comanda nada e nunca ganha a marca de trava. 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).