Guia de Ajuda InstaFind

Controla se a extensão está ativa ou completamente inativa.

• Como usar: No popup da extensão, use a caixa de seleção "Ativar/Desativar Extensão".
• Marcado: A extensão funcionará de acordo com os outros modos configurados.
• Desmarcado: A extensão não realizará nenhuma busca ou destaque. Todos os destaques ativos serão removidos.

Busca e destaca o texto que você seleciona com o mouse.

• Como usar:
  1. No popup, certifique-se de que "Ativar com Hover" e "Ativar Double Check" estejam desmarcados.
  2. Na página, simplesmente selecione qualquer texto com o mouse.
• Resultado: Todas as ocorrências do texto selecionado serão destacadas em amarelo. Um contador no canto da tela mostrará o número de resultados.

Busca e destaca a palavra sobre a qual o mouse está atualmente.

• Como usar:
  1. No popup, marque a caixa de seleção "Ativar com Hover".
  2. Na página, passe o mouse sobre qualquer palavra.
• Resultado: A palavra sob o cursor será destacada em amarelo. Um contador mostrará o número de resultados.

Realiza uma busca contextual usando duas palavras.

• Como usar:
  1. No popup, marque a caixa de seleção "Ativar Double Check".
  2. Este modo funciona em conjunto com a Busca por Seleção ou Busca por Hover:
     • Com Busca por Seleção Ativa: Selecione uma única palavra.
     • Com Busca por Hover Ativa: Passe o mouse sobre uma única palavra.
• Como funciona:
  • A extensão identifica a palavra com a qual você interagiu (Palavra A) e a palavra imediatamente seguinte no texto (Palavra B).
  • Em seguida, ela realiza duas buscas independentes:
    • Todas as ocorrências da Palavra A são destacadas em amarelo.
    • Todas as ocorrências da Palavra B são destacadas em azul claro.
• Contador: O contador exibirá os resultados para ambas as palavras (ex: "Palavra A: 5 | Palavra B: 3").

Permite definir palavras que a extensão deve ignorar, sem iniciar uma busca por elas.

• Como usar:
  1. No popup da extensão, localize a área de texto "Palavras a Ignorar".
  2. Insira as palavras que deseja ignorar, separadas por vírgulas (ex: o, a, de, para).
  3. Clique no botão "Salvar Palavras" ao lado da área de texto para aplicar as alterações.
• Lógica e Resultado:
  • Se a Palavra Interagida Estiver na Lista: (Seja por seleção ou hover, e não no modo Double Check)
    • A palavra será destacada em vermelho e com um risco.
    • Nenhuma busca será realizada para essa palavra.
  • No Modo Double Check:
    • Cenário 1: Primeira Palavra Ignorada: Se a Palavra A (interagida) estiver na lista de ignoradas, a busca por ambas as palavras é cancelada. A Palavra A é destacada em vermelho. O contador não exibe nada.
    • Cenário 2: Segunda Palavra Ignorada (Primeira Não Ignorada): Se a Palavra A NÃO estiver na lista, mas a Palavra B ESTIVER, a busca pela Palavra A prossegue normalmente (destacada em amarelo). A Palavra B não é buscada, mas é destacada em vermelho (com risco). O contador exibe apenas o resultado para a Palavra A.

Destaca automaticamente todas as palavras em negrito ou na página com uma cor de fundo e de fonte personalizáveis. Esta função opera independentemente das buscas de texto.

• Como usar: No popup, marque a caixa de seleção "Destacar Negritos".
• Configuração de Cores: No popup, na seção "Opções Visuais", você encontrará dois seletores para o destaque de negrito:
  • "Negrito (Fundo)": Define a cor de fundo do destaque.
  • "Negrito (Fonte)": Define a cor do texto das palavras em negrito.
• Resultado: Todas as palavras em negrito na página serão destacadas com as cores configuradas. A função é ativada no carregamento da página e monitora dinamicamente novas palavras em negrito que possam ser adicionadas ao DOM.

Permite que a extensão funcione apenas em domínios específicos, garantindo que não seja ativada em sites indesejados.

• Como usar:
  1. No popup da extensão, marque a caixa de seleção "Habilitar Filtro de Domínios" para ativar o filtro.
  2. Na área de texto "Permitir apenas nos domínios", insira os domínios onde a extensão deve funcionar, separados por vírgulas (ex: google.com, wikipedia.org, .meusite.com).
     • Para permitir subdomínios, comece o domínio com um ponto (ex: .google.com permitirá mail.google.com, docs.google.com, etc.).
     • Para domínios exatos, não use o ponto inicial (ex: google.com permitirá apenas google.com).
  3. Clique no botão "Salvar Domínios" ao lado da área de texto para aplicar as alterações.
• Lógica e Resultado:
  • Se a caixa de seleção "Habilitar Filtro de Domínios" estiver marcada e a lista de domínios estiver não vazia, a extensão funcionará apenas nos domínios listados.
  • Se a caixa de seleção estiver marcada e a lista de domínios estiver vazia, a extensão não funcionará em nenhum site.
  • Se a caixa de seleção estiver desmarcada (padrão), a extensão funcionará em todos os sites, independentemente da lista de domínios.

Animação de Destaque (Fade-in)

Adiciona um efeito de transição suave (fade-in) ao destacar palavras na página.

• Como usar: No popup, marque/desmarque a caixa "Animação de Destaque".

Personalização de Cores

Permite personalizar as cores usadas para diferentes tipos de destaques.

• Cores Gerais: Você pode definir cores personalizadas para o destaque principal, o destaque do "Double Check", palavras ignoradas e texto em negrito.
• Cores da Busca Baseada em Classe: Você pode definir uma paleta personalizada de 5 cores para o recurso de Busca Baseada em Classe.
• Como usar:
  1. No popup, vá para a seção "Opções Visuais".
  2. Use os seletores de cor para escolher as cores desejadas.
  3. Clique no botão "Salvar Cores" para aplicar suas alterações.
  4. Clique no botão "Restaurar Padrão" para reverter todas as cores para suas configurações originais.

Exibe o número de ocorrências encontradas diretamente no ícone da extensão na barra do Chrome.

• Como usar: No popup, marque/desmarque a caixa "Mostrar Contador no Ícone".
• Lógica:
  • Modo de Seleção/Hover Simples: O badge mostrará o número total de ocorrências encontradas (ex: 5).
  • Modo "Double Check": O badge mostrará a contagem das duas palavras separadamente (ex: 5-3).
  • Palavra Ignorada: Se a palavra interagida estiver na lista de ignoradas, o badge mostrará X.

Exibe uma pequena interface de usuário flutuante na página com a lista de ocorrências encontradas.

• Como usar: No popup, marque/desmarque a caixa "Habilitar Painel Flutuante".
• Recursos:
  • O painel pode ser arrastado para qualquer posição na tela.
  • Pode ser redimensionado usando as bordas.
  • Exibe a lista de palavras e suas contagens.
  • Possui um botão "X" para fechar o painel.

Busca e destaca automaticamente o conteúdo de texto de elementos HTML específicos, definidos por tag e classe. Este recurso usa uma lógica de busca segmentada única.

• Como usar:
  1. No popup, marque a caixa de seleção "Habilitar Busca Baseada em Classe".
  2. Na área de texto "Elementos Alvo (um por linha)", insira os seletores para os elementos que você deseja segmentar (ex: div.post-content, span.product-name, ou div.info-entry).
  3. Opcionalmente, ajuste o "Comprimento mínimo da palavra" para controlar o comprimento mínimo das palavras a serem buscadas.
  4. Clique no botão "Salvar Elementos" para aplicar as alterações.
• Como funciona (Busca Segmentada):
  1. A extensão encontra todos os elementos na página que correspondem aos seus seletores e os classifica na ordem em que aparecem.
  2. A página é então dividida em "segmentos de busca". Um segmento começa em um elemento alvo (incluindo seu conteúdo) e termina pouco antes do próximo elemento alvo.
  3. Para cada elemento alvo:
     • A extensão extrai todas as palavras únicas de dentro dele (incluindo seu conteúdo de texto e respeitando a lista de palavras ignoradas e o comprimento mínimo).
     • Em seguida, ela busca por essas palavras apenas dentro do seu segmento correspondente, que inclui o próprio elemento alvo.
• Lógica de Cores (Indexação Reversa):
  • A cor de cada palavra destacada é determinada por sua posição na lista de palavras extraídas do elemento alvo, mas em ordem inversa.
  • A última palavra única no elemento alvo recebe a primeira cor da paleta personalizada.
  • A penúltima palavra recebe a segunda cor, e assim por diante.
  • A paleta de cores é sequencial e volta ao início se necessário. Esta sequência de cores é redefinida para cada novo elemento alvo.
  • Exemplo: Se um elemento alvo contém as palavras únicas "Maçã Banana Cereja", então:
    • "Cereja" (a última palavra) recebe a 1ª cor da sua paleta personalizada.
    • "Banana" (a palavra do meio) recebe a 2ª cor.
    • "Maçã" (a primeira palavra) recebe a 3ª cor.
• Dinâmico: Este recurso funciona no carregamento inicial da página e reage dinamicamente às atualizações da página, tornando-o ideal para sites modernos e ricos em conteúdo.

• Destaque Visual: As palavras são destacadas com cores distintas para cada função.
• Eficiência: Construído para ter impacto mínimo no desempenho, ignorando campos de texto (como 'input' e 'textarea') e otimizando a detecção.
• Manifest V3: Desenvolvido com a plataforma mais recente de extensões do Chrome para segurança e desempenho.

Para instalar a extensão em seu navegador Google Chrome:

1. Baixe e descompacte os arquivos da extensão em uma pasta.
2. Abra o Google Chrome e digite chrome://extensions na barra de endereços.
3. Habilite o "Modo desenvolvedor" no canto superior direito.
4. Clique em "Carregar sem compactar" e selecione a pasta onde você descompactou os arquivos da extensão.
5. A extensão "InstaFind" aparecerá em sua lista.

• Desempenho: Embora a extensão seja otimizada, em páginas extremamente grandes ou com atualizações dinâmicas muito frequentes, pode haver um leve impacto no desempenho, especialmente com a funcionalidade "Destacar Negritos" ativa.
• Compatibilidade: A extensão foi desenvolvida para Chrome e Manifest V3. A compatibilidade com outros navegadores baseados em Chromium pode variar.
• Conflitos: Em raras ocasiões, a extensão pode entrar em conflito com scripts de outras extensões ou da própria página que manipulam agressivamente o DOM. Se você notar um comportamento inesperado, tente desativar temporariamente outras extensões.