Listas Dependentes
Filtre opções de forma dinâmica entre campos
As Listas Dependentes são um padrão de configuração que cria um relacionamento entre dois campos de seleção: a opção escolhida no primeiro campo determina automaticamente quais opções serão exibidas no segundo campo.
Esse comportamento funciona com qualquer combinação de tipos de lista — padrão com padrão, padrão com aninhada ou aninhada com aninhada — e em todos os campos de seleção que carregam listas, incluindo os de seleção múltipla.
Quando usar este padrão
Utilize Listas Dependentes quando precisar que a escolha em um campo restrinja as opções disponíveis em outro.
É ideal para:
- Estado → Cidade (selecionar o estado filtra as cidades disponíveis)
- Área → Serviço (selecionar a área da empresa filtra os serviços oferecidos)
- Categoria → Produto (selecionar a categoria filtra os produtos daquela categoria)
- Departamento → Cargo (selecionar o departamento filtra os cargos disponíveis)
- Qualquer cenário onde uma seleção determine as opções seguintes
Como funciona
O mecanismo de dependência funciona através da correspondência entre o valor da opção selecionada no campo principal e a referência manual inserida na lista dependente. Quando o usuário escolhe uma opção, o sistema busca automaticamente a lista cuja referência coincide com aquele valor.
O padrão exige três elementos configurados:
- Lista principal — vinculada ao primeiro campo (campo-pai). Cada opção possui um valor técnico gerado automaticamente a partir do rótulo.
- Listas dependentes — uma lista para cada opção da principal. O campo Referência de cada lista dependente deve ser preenchido manualmente com um valor idêntico ao valor da opção correspondente na lista principal.
- Campo com múltiplas listas — o segundo campo (campo-filho) deve ter a opção Múltiplas listas ativada e apontar para o campo-pai como referência.
Configurações específicas
Campo-pai (lista principal)
| Configuração | Descrição |
|---|---|
| Tipo de campo | Qualquer campo de seleção que carregue listas (Lista de Seleção Única, Botões de Seleção Única, Caixas de Seleção, Lista de Seleção Múltipla). |
| Origem da Lista | Listas |
| Lista | A lista principal que contém as opções de primeiro nível. |
Campo-filho (listas dependentes)
| Configuração | Descrição |
|---|---|
| Tipo de campo | Qualquer campo de seleção que carregue listas. |
| Origem da Lista | Listas |
| Múltiplas listas | Deve estar ativado. |
| Campo referência da lista | Selecione o campo-pai que controla o filtro. |
| Lista | Adicione todas as listas dependentes (uma para cada opção do campo-pai). |
Como configurar
Crie a lista principal
Acesse Configurações > Estrutura > Listas e crie uma lista do tipo Lista Padrão ou Lista Aninhada.
Adicione as opções de primeiro nível. Anote os valores técnicos de cada opção (exibidos no campo "Valor" ao editar a opção).
Crie uma lista para cada opção
Para cada opção da lista principal, crie uma lista separada. No campo Referência de cada lista dependente, insira manualmente um valor idêntico ao valor da opção correspondente na lista principal.
O campo Referência nas listas é opcional e não é gerado automaticamente. Você deve preenchê-lo manualmente com o mesmo valor da opção na lista principal para que a dependência funcione.
Exemplo:
- Opção "Administração" (valor:
Administration) na lista principal → lista dependente com referência manualAdministration - Opção "Contabilidade" (valor:
Bookkeeping) na lista principal → lista dependente com referência manualBookkeeping - Opção "Desenvolvimento de Negócios" (valor:
Business_Development) na lista principal → lista dependente com referência manualBusiness_Development
Configure o campo-pai
Na categoria desejada, acesse Campos e crie um campo de seleção:
- Tipo: Lista de Seleção Única (ou outro tipo de seleção)
- Origem da Lista: Listas
- Lista: selecione a lista principal criada no passo 1
Configure o campo-filho
Crie o segundo campo de seleção na mesma categoria:
- Tipo: Lista de Seleção Única (ou outro tipo de seleção, incluindo múltipla)
- Origem da Lista: Listas
- Múltiplas listas: ative o toggle
- Campo referência da lista: selecione o campo-pai configurado no passo anterior
- Lista: adicione todas as listas dependentes criadas no passo 2
Salve os campos
Clique em Salvar em ambos os campos. A dependência estará ativa.
Teste no formulário
Ao preencher o formulário, selecione uma opção no campo-pai. O campo-filho atualizará automaticamente exibindo apenas as opções da lista cuja referência corresponde ao valor selecionado.
Exemplo prático
Cenário: Uma empresa de serviços deseja classificar atendimentos por Área e Serviço.
Lista principal — "Áreas da Empresa":
| Ordem | Rótulo | Valor |
|---|---|---|
| 01 | Administração | Administration |
| 02 | Contabilidade | Bookkeeping |
| 03 | Desenvolvimento de Negócios | Business_Development |
Listas dependentes:
| Referência da lista | Opções |
|---|---|
Administration | Taxas de Processamento, Reembolso, Taxa de Retenção, Endereço de Serviço, Geral |
Bookkeeping | Relatório Mensal, Declaração Anual, Folha de Pagamento |
Business_Development | Prospecção, Proposta Comercial, Follow-up |
Configuração dos campos:
- Campo "Área" (campo-pai): Lista de Seleção Única, carregando "Áreas da Empresa"
- Campo "Serviço" (campo-filho): Lista de Seleção Única, com Múltiplas listas ativadas, referência "Área", carregando as três listas dependentes
Resultado: Ao selecionar "Administração" no campo "Área", o campo "Serviço" exibe automaticamente: Taxas de Processamento, Reembolso, Taxa de Retenção, Endereço de Serviço, Geral.
Comportamento dos dados
Algumas características das listas dependentes afetam a experiência de uso:
- A correspondência entre valor e referência é sensível a maiúsculas/minúsculas e acentuação.
- Se o usuário selecionar uma opção no campo-pai que não possui lista dependente correspondente, o campo-filho aparecerá vazio.
- Se o campo-pai for alterado após o campo-filho já ter sido preenchido, o valor do campo-filho é limpo automaticamente.
- O filtro funciona em tempo real, sem necessidade de salvar o formulário.
- Funciona com todos os tipos de seleção que carregam listas, incluindo seleção múltipla.
- A dependência pode ser combinada com Caixa de Busca e Editável nos campos de seleção.
Boas práticas
- Padronize os valores técnicos da lista principal em um formato claro (ex: snake_case ou PascalCase) para facilitar a criação das referências das listas dependentes.
- Crie uma lista dependente para todas as opções da lista principal, mesmo que algumas fiquem vazias, para evitar campos-filho vazios no formulário.
- Utilize nomes descritivos nas listas dependentes para identificar facilmente a qual opção elas pertencem (ex: "Serviços — Administração").
- Teste a dependência com todas as opções da lista principal antes de colocar o formulário em produção.
- Documente a estrutura de dependência na descrição da categoria para facilitar a manutenção futura.