TreeSelect
Escolhido
Vazio
import { TreeSelect } from '@rivocode/ui'Quando usar
Escolha dentro de uma arvore: setor e equipe, categoria e subcategoria, conta e centro de custo.
Quem vale e a folha. O valor sai como lista de ids de folha; marcar um pai marca todas as folhas debaixo dele. Guardar o pai junto criaria dois jeitos de dizer a mesma coisa.
O gatilho resume em vez de listar: até três nomes eles aparecem, passando disso
vem o número. Nome cortado no meio diz menos do que "7 escolhidos". Sem
escolha, ele diz "Selecione", o mesmo do Select e do nativo, e o
placeholder troca.
value, defaultValue e onValueChange são os mesmos do Tree: trocar o
painel pela árvore inline, ou o contrário, é mexer no nome da peça e em mais
nada.
O clique marca, a seta abre
O painel abre com todos os galhos fechados, e clicar no nome de um galho
não o abre: marca de uma vez todas as folhas debaixo dele. Quem monta a tela
clica em "Financeiro" esperando ver as filhas, lê "Contas a pagar, Contas a
receber" no gatilho e conclui que a peça quebrou. Não quebrou: no padrão
treeview do WAI-ARIA a linha inteira é o alvo da escolha, e abrir e
fechar é papel à parte — sem essa divisão não haveria como marcar um galho sem
antes visitar as folhas de dentro dele.
Abrir tem três caminhos, e nenhum deles é o nome: a setinha à esquerda dele, a
tecla → com a linha em foco, ou a busca — enquanto há texto no campo a árvore
fica inteira aberta, e aí as setas de abrir e fechar não têm o que fazer. Já
dentro dela, ↑ e ↓ andam pelas linhas visíveis, ← fecha o galho ou sobe
para o pai, e espaço marca. Em dir="rtl" as duas horizontais trocam de
papel, pela razão que está na página do Tree.
A árvore é uma parada de tabulação só: o Tab passa pela busca e para na
linha que teve foco por último, a primeira quando nenhuma teve, e daí em diante
são as setas, com Home e End nas pontas. Não é o Tab que percorre as
linhas.
No celular o painel vira folha de baixo, como o do Select, do Combobox e dos
calendários; labels.title é o nome que o leitor de tela ouve nela, e o padrão
é "Escolher itens". Dentro de <Field disabled>, o gatilho fica desligado.
Quando não usar
Para navegar pastas na própria tela, sem campo, use Tree: é a mesma árvore,
solta. O TreeSelect é a árvore dentro de um campo de formulário, que fecha e
resume a escolha no gatilho.
Quando a lista não tem hierarquia de verdade, a árvore só acrescenta cliques:
lista curta e fixa é Select, e lista longa ou vinda do servidor é Combobox,
que busca.
No React Native
Traduz: é o Tree nativo dentro da folha de baixo, com a mesma navegação por níveis. E por isso ele resolve o que os dois Select encadeados, que esta página mandava usar, nunca resolveram: a profundidade não é fixa, e o segundo Select só sabia existir depois que alguém escolhia no primeiro.
O rodapé é a metade que o web não precisa ter. No desktop o painel fica ao lado do gatilho, e o gatilho conta quantos foram; sob uma folha não há gatilho à vista, então a contagem vive no rodapé, junto do Aplicar, e ela conta o rascunho, que é o único número que responde "quantos eu já marquei?" enquanto a pessoa ainda está marcando. O texto sai do mesmo resumo do Select e do Combobox, de propósito.
Sair pela lateral desiste, e o Aplicar é a única porta que confirma, a mesma divisão do DateRangePicker: o toque no fundo escurecido é o gesto de quem se arrependeu, e ele não pode valer como aplicar. Sem searchable, pela razão que está na página do Tree.
API
| Prop | Tipo | Padrão |
|---|---|---|
itemsobrigatória0.4.0 | TreeNode[] | sem padrão |
defaultValue0.4.0 | string[] | sem padrão |
labelsOs textos da peca, para trocar o idioma: `title` e o nome do painel, lido no celular, onde ele vira folha; `search` e o nome do campo de busca, `searchPlaceholder` o texto de espera dele e `selected` o resumo do gatilho com mais de tres escolhas. | Partial<TreeSelectLabels> | sem padrão |
multiple0.4.0 | boolean | true |
onValueChange0.4.0 | ((ids: string[]) => void) | sem padrão |
placeholder0.4.0O que o gatilho mostra sem escolha. | string | "Selecione" |
searchable0.4.0Mostra o campo de busca dentro do painel. | boolean | true |
size0.4.0 | "lg""md""sm" | sem padrão |
value0.4.0Ids das folhas escolhidas. | string[] | sem padrão |
Além destas, a peça aceita className, style, id e children, repassados ao elemento de baixo.