EXEMPLOS
Instruções de uso
1. Ativar o ID nos elementos

Em Settings → General, marque Expose the option to add an ID attribute to HTML elements.

Sem isso o plugin não consegue localizar o input, e nada funciona.

2. Montar na página

Coloque um Input comum e o elemento Dropdown de Busca. O elemento do plugin é invisível — ele não desenha nada na tela, apenas comanda o input.

No input, na aba Appearance, preencha o ID Attribute com algo único, por exemplo busca_pet.

3. Configuração básica

Selecione o elemento do plugin e preencha:

Campo Exemplo
id busca_pet — o mesmo ID que você deu ao input
tipo Pets
origem Do a search for Pets
rotulo nome

Com isso já funciona: o usuário digita, as sugestões aparecem, e ao escolher uma o registro fica disponível em item_selecionado.

4. Exibir informações extras

Para diferenciar registros parecidos, adicione até três informações por sugestão.

Cada bloco tem três campos. Exemplo para mostrar a ficha ao lado do nome e o tutor abaixo:

Campo Valor
linha_2 Do a search for Pets:each item's ficha
prefixo_2 Ficha
pos_2 Mesma linha
linha_3 Do a search for Pets:each item's Tutor's Nome
prefixo_3 Tutor -
pos_3 Linha nova

Resultado:

Domenico  Ficha 30
Tutor - Luciana Maciel

Atenção: as buscas de linha_2, linha_3 e linha_4 precisam ser idênticas à de origem — mesmos filtros, mesma ordenação. Só o :each item's do final muda. Copie a expressão do origem e cole nas outras, editando apenas o final.

Se elas divergirem, a informação apareceria no registro errado. O plugin detecta e desativa o bloco, avisando no console.

O prefixo é concatenado literalmente — inclua o espaço no fim.

5. Controlar quando os dados são carregados

Este ajuste define o consumo de Workload Units.

Listas pequenas — deixe min_caracteres vazio ou em 0. A lista vem junto com a página e a busca funciona desde a primeira tecla.

Listas grandes — preencha min_caracteres com 3 e o campo gatilho com o state termo_busca deste mesmo elemento.

Assim nada é carregado até alguém digitar três caracteres. Telas onde ninguém usa a busca não consomem nada. O carregamento acontece uma vez só enquanto o usuário permanecer na página.

O gatilho é obrigatório nesse modo — é ele que avisa o plugin para carregar.

6. Usar o resultado

Depois que o usuário escolhe uma sugestão:

Dropdown A's item_selecionado's Tutor's Nome
Dropdown A's item_selecionado's raça
Dropdown A's valor_selecionado

O item_selecionado é o registro completo, então você navega por qualquer campo dele.

Para reagir à escolha, use o evento Um item foi selecionado em um workflow.

Se algo não funcionar
Sintoma Causa provável
Nada acontece ao digitar O id não corresponde ao ID Attribute do input, ou a opção de expor ID está desativada
Fica em "Digite pelo menos N caracteres" e não carrega O campo gatilho está vazio
Informação aparece no registro errado As buscas dos blocos não são idênticas à origem. Veja o console
Busca não encontra nome com acento Abra o console e digite typeof MiniSearch. Deve retornar function

O state indexados mostra quantos registros estão carregados — útil para confirmar se o carregamento aconteceu.