Toolbar
Formatação
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
| Prop | Tipo | Padrão |
|---|---|---|
disabled0.4.0 | boolean | sem padrão |
loopFocus0.4.0Com `true`, o foco do teclado volta para a outra ponta da barra ao chegar no fim. | boolean | true |
orientation0.4.0A orientação da barra de ferramentas. | Orientation | "horizontal" |
render0.4.0Troca 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.