Pular para o conteúdo
Navegação

Tabs

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

Básico

Doze mensalidades aguardando pagamento.

Com aba desabilitada

Nome, data de nascimento e convênio do paciente.
Importar
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

PropTipoPadrão
defaultValue0.4.0

O valor inicial.

any0
onValueChange0.4.0

Chamado quando um valor novo é escolhido.

((value: any, eventDetails: TabsRootChangeEventDetails) => void)sem padrão
orientation0.4.0

A orientação da peça (a direção do fluxo).

Orientation"horizontal"
render0.4.0

Troca 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.0

O valor da `Tab` ativa agora.

anysem 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.

Uma 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.

PropTipoPadrão
valueobrigatória0.4.0

O valor da aba.

anysem padrão
disabled0.4.0

Se a aba está desabilitada.

booleansem padrão
nativeButton0.4.0

Se a peça renderiza um `<button>` nativo quando é trocada pela prop `render`.

booleantrue
render0.4.0

Troca 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.

A 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.

PropTipoPadrão
activateOnFocus0.4.0

Se a aba ativa troca sozinha quando as setas movem o foco.

booleanfalse
loopFocus0.4.0

Se o foco do teclado volta ao primeiro item ao chegar no fim da lista pelas setas.

booleantrue
render0.4.0

Troca 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.

O 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.

PropTipoPadrão
valueobrigatória0.4.0

O valor do painel da aba.

anysem padrão
keepMounted0.4.0

Se o elemento HTML fica no DOM com o painel escondido.

booleanfalse
render0.4.0

Troca 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.

@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.