Tabs
Básico
Com aba desabilitada
import { Tabs } from '@rivocode/ui'Quando usar
Alterna painéis irmãos na mesma página.
Compõe com TabList, Tab e TabPanel, casando value entre aba e painel. O
risco que corre até a aba ativa se posiciona sozinho.
TabList tem variant, do tipo TabVariant. O risco embaixo, que é o padrão,
diz "esta parte da página". A caixinha, variant="segmented", diz "a mesma
coisa, de outro jeito": largura de tela, preview e código, escuro e claro.
Trocar uma pela outra faz o controle prometer o que ele não faz.
Quando não usar
Não use para navegação entre páginas: aba sugere que o conteúdo está ali do
lado, não em outro endereço. Se o clique troca a URL, é link, e o lugar dele é
a NavigationMenu ou a Sidebar.
No React Native
Traduz pela metade, de propósito. O Tabs nativo é só a caixinha (variant="segmented" no web): items, value, onValueChange, sem TabList, Tab nem TabPanel. Aba que troca a seção da página não é peça no celular (é tab bar do router), e insistir numa aba desenhada por cima disso dá duas navegações concorrentes na mesma tela.
O contador entra por count em cada TabItem: o número sai pequeno ao lado do nome, e o leitor de tela ouve "Pendentes, 3". No web, onde a Tab recebe filhos, o número vai dentro dela. O ícone entra pelo icon do item, antes do nome, e a função recebe a cor da aba, ativa ou não.
API
| Prop | Tipo | Padrão |
|---|---|---|
defaultValue0.4.0O valor inicial. | any | 0 |
onValueChange0.4.0Chamado quando um valor novo é escolhido. | ((value: any, eventDetails: TabsRootChangeEventDetails) => void) | sem padrão |
orientation0.4.0A orientação da peça (a direção do fluxo). | Orientation | "horizontal" |
render0.4.0Troca o elemento HTML da peça por outra tag, ou a compõe com outro componente. | ComponentRenderFn<HTMLProps, TabsRootState> | ReactElement<unknown, string | JSXElementConstructor<any>> | sem padrão |
value0.4.0O valor da `Tab` ativa agora. | any | sem padrão |
Além destas, a peça aceita className, style, id e children, repassados ao elemento de baixo.
Partes
Tabs se monta com estas peças. Todas vivem nesta página, porque separar cada uma num endereço obrigaria a abrir seis abas para montar uma tela.
Tab
/tab.mdUma aba da fila.
O value amarra a aba ao TabPanel do mesmo valor. A seta anda entre as abas
sem selecionar, e Enter ou Espaço escolhe: é a ativação manual, que não troca
o painel a cada tecla.
O ícone ao lado do rótulo entra sem size: sai com 16px, e com 14px na fila
segmented, que tem letra menor. disabled deixa a aba à vista e fora do alcance, para
quando a pessoa precisa saber que a seção existe.
Escreva o rótulo curto, de uma ou duas palavras: a fila rola de lado quando não cabe, e aba que pede frase é sinal de que o conteúdo queria outra peça.
| Prop | Tipo | Padrão |
|---|---|---|
valueobrigatória0.4.0O valor da aba. | any | sem padrão |
disabled0.4.0Se a aba está desabilitada. | boolean | sem padrão |
nativeButton0.4.0Se a peça renderiza um `<button>` nativo quando é trocada pela prop `render`. | boolean | true |
render0.4.0Troca o elemento HTML da peça por outra tag, ou a compõe com outro componente. | ComponentRenderFn<HTMLProps, TabsTabState> | ReactElement<unknown, string | JSXElementConstructor<any>> | sem padrão |
Além destas, a peça aceita className, style, id e children, repassados ao elemento de baixo.
TabList
/tab-list.mdA fila de abas.
Rola de lado quando não cabe, em vez de espremer ou quebrar linha: aba em duas linhas vira menu disfarçado, e no celular quase nenhuma fila de aba cabe inteira. A barra de rolagem fica escondida de propósito, o gesto continua valendo, e no desktop a aba ativa se traz para a vista sozinha pelo foco do teclado.
| Prop | Tipo | Padrão |
|---|---|---|
activateOnFocus0.4.0Se a aba ativa troca sozinha quando as setas movem o foco. | boolean | false |
loopFocus0.4.0Se o foco do teclado volta ao primeiro item ao chegar no fim da lista pelas setas. | boolean | true |
render0.4.0Troca o elemento HTML da peça por outra tag, ou a compõe com outro componente. | ComponentRenderFn<HTMLProps, TabsListState> | ReactElement<unknown, string | JSXElementConstructor<any>> | sem padrão |
variant0.4.0`underline` divide uma pagina em secoes; `segmented` troca a forma de ver a mesma coisa, como largura de tela ou preview e codigo. | TabVariant | "underline" |
Além destas, a peça aceita className, style, id e children, repassados ao elemento de baixo.
TabPanel
/tab-panel.mdO conteúdo de uma aba.
O value amarra painel e aba. Só o painel ativo fica no documento, então
formulário dentro de aba escondida não entra no Tab do teclado.
| Prop | Tipo | Padrão |
|---|---|---|
valueobrigatória0.4.0O valor do painel da aba. | any | sem padrão |
keepMounted0.4.0Se o elemento HTML fica no DOM com o painel escondido. | boolean | false |
render0.4.0Troca o elemento HTML da peça por outra tag, ou a compõe com outro componente. | ComponentRenderFn<HTMLProps, TabsPanelState> | ReactElement<unknown, string | JSXElementConstructor<any>> | sem padrão |
Além destas, a peça aceita className, style, id e children, repassados ao elemento de baixo.