Pular para o conteúdo
Ações

Toolbar

/componentes/toolbar.mdmarkdown cru, para quem lê com agent em vez de olho

Formatação

Importar
import { Toolbar } from '@rivocode/ui'

Quando usar

Barra de ferramentas: os controles ficam numa parada de tabulação só, e as setas andam entre eles.

É isso que a diferencia de uma div com botões: dez botões soltos são dez paradas de Tab entre o campo anterior e o próximo. Numa barra, é uma.

<Toolbar>
  <ToolbarButton render={<Toggle />}>Negrito</ToolbarButton>
  <ToolbarButton render={<Toggle />}>Italico</ToolbarButton>
  <ToolbarSeparator />
  <ToolbarButton render={<Button variant="ghost" />}>Limpar formato</ToolbarButton>
</Toolbar>

Use ToolbarButton com render para vestir Button, Toggle ou Select sem perder essa navegação.

As partes

ToolbarGroup junta botões que fazem parte do mesmo assunto (alinhar à esquerda, ao centro, à direita), e o ToolbarSeparator separa um grupo do outro. Para o leitor de tela, o grupo é o que diz que as três opções são uma escolha só.

Moldura e tom

A barra nasce com moldura - borda, fundo de superfície e respiro -, para ficar solta na página. Dentro de algo que já tem moldura, o cabeçalho de um Card ou o topo de um editor, variant="plain" tira as três e deixa só a fileira: moldura dentro de moldura é traço sobrando.

O hover do botão é o da superfície neutra (surface-hover, e surface-active no clique), o mesmo do resto dos controles neutros da casa. O botão marcado, de um Toggle, continua em accent-subtle, que é estado e não passagem do ponteiro.

tone="danger" é o botão que destrói - excluir, descartar, revogar: texto e ícone em danger-text, hover em danger-subtle. Os dois pares são medidos sobre a página e sobre a superfície, então valem nas duas formas da barra.

<Toolbar variant="plain" aria-label="Ações da nota">
  <ToolbarButton>Duplicar</ToolbarButton>
  <ToolbarSeparator />
  <ToolbarButton tone="danger">Excluir</ToolbarButton>
</Toolbar>

Quando não usar

Para duas ou três ações irmãs, sem a navegação por setas, use ButtonGroup: cada botão continua sendo uma parada de Tab, que é o que se espera de um punhado de botões.

Ações sobre as linhas marcadas de uma listagem são ActionBar, que aparece com a seleção e diz quantas são. E a barra de Arquivo e Editar de uma ferramenta é Menubar.

No React Native

Não porta, por decisão - superfície de edição de mesa: uma parada de tabulação e navegação por seta, que o toque não tem. Não é fila: não vai existir. A tabela de paridade diz o porquê de cada uma.

API

PropTipoPadrão
disabled0.4.0booleansem padrão
loopFocus0.4.0

Com `true`, o foco do teclado volta para a outra ponta da barra ao chegar no fim.

booleantrue
orientation0.4.0

A orientação da barra de ferramentas.

Orientation"horizontal"
render0.4.0

Troca o elemento HTML da peça por outra tag, ou a compõe com outro componente.

ComponentRenderFn<HTMLProps, ToolbarRootState> | ReactElement<unknown, string | JSXElementConstructor<any>>sem padrão
variant

`outline` desenha a moldura: borda, fundo de superficie e respiro, para a barra solta na pagina.

"outline" | "plain""outline"

Além destas, a peça aceita className, style, id e children, repassados ao elemento de baixo.

@rivocode/ui, 149 peças no catálogo. Esta página é gerada dos mesmos arquivos que alimentam o design system, então ela não envelhece sozinha.

Feito por RivoCode.