Pular para o conteúdo principal
Design System
GitHub

Iconografia

O Phosphor é a única biblioteca de ícones do design system, e ela inteira está disponível: cerca de 1.500 ícones em seis pesos. O peso não é escolha de gosto: cada um tem um papel, e é isso que mantém a interface coesa.

Os seis pesos​

Tamanho: 32px32
RegularPadrão da interface
FillEstado ligado
BoldAté 14px ou fundo sólido
LightÍcones grandes, 32–48px
ThinEditorial, 64px+
DuotoneDestaque ilustrativo
PesoPapelOndeNunca
RegularPadrão da interfaceNavegação, botões, campos, ícones junto de texto (16–24px)—
FillEstado "ligado"Item ativo no SideNav, aba selecionada, favorito marcado, ícone de status em Alert e Toast, check do Checkbox (check-fat em 12px). Sempre em par com o regular do estado desligado.Decoração; misturar com regular sem ser troca de estado
BoldLegibilidade em tamanho pequeno ou sobre fundo sólidoÍcones de até 14px; glifos sobre preenchimento coloridoTamanhos grandes; ênfase decorativa
LightÍcone grande e calmoEstados vazios e ilustrações de 32–48pxAbaixo de 32px, onde fica fino demais
ThinMomento editorialHero, capas e peças de marca, a partir de 64pxQualquer tela operacional
DuotoneDestaque ilustrativoOnboarding, cards de funcionalidade, estado vazio de destaqueInterfaces densas, tabelas, navegação

Regras​

  • Um peso por região. Numa mesma barra, lista ou grupo de botões, todos os ícones usam o mesmo peso. A única exceção é a troca de estado regular ↔ fill (o item ativo ganha fill; os outros continuam regular).
  • O peso acompanha o tamanho. Até 14px, bold; de 16 a 24px, regular; de 32 a 48px, light; a partir de 64px, thin.
  • Duotone e thin nunca entram em componentes do pacote, só em composições de página.
  • Cor: currentColor por padrão, herdando do texto. O duotone usa a mesma cor, com a segunda camada em opacidade reduzida (definida pelo próprio Phosphor).
  • Sem emoji, sem outras bibliotecas e sem SVG desenhado à mão. Marcas de terceiros usam os glifos ph-<marca>-logo do Phosphor, na cor da marca; marca sem glifo no Phosphor não é implementada.
  • Ícone não substitui texto, exceto os ícones conhecidos (fechar, buscar, menu, voltar), que sempre levam um aria-label no botão.
Faça

Item ativo do menu em fill e os demais em regular, todos no mesmo tamanho.

Evite

Misturar bold e regular na mesma barra só porque um ícone "ficou fraco": ajuste o tamanho, não o peso.

Faça

Estado vazio com ícone light de 40px acima do texto.

Evite

Ícone thin ou duotone dentro de botões, campos, tabelas ou navegação.

Como usar​

import { Ph, Icons } from '@onblide/ui';

<Ph n="house" /> // regular (padrão)
<Ph n="house" weight="fill" /> // estado ligado
<Ph n="check" size={12} weight="bold" />
<Icons.star weight="fill" /> // o registro Icons também aceita peso

Os seis pesos já vêm em @onblide/ui/styles.css. Cada fonte só é baixada pelo navegador quando algum ícone usa aquele peso, então disponibilizar a biblioteca inteira não pesa para quem usa só o regular.

Todos os ícones​

Busque pelo nome em inglês, troque o peso e clique num ícone para ver o código.

Componentes: Ph e Icons. Logos de marcas de terceiros usam os glifos *-logo do Phosphor pelo Ph.