Catálogo SPA com React: Busca Debounced e Rotas
⚡ Curso de React.js • Web-ZoneWare

Projeto Prático 3: Catálogo SPA Completo com Busca Debounced, Filtros e Rotas Dinâmicas

Lição 49 de 50

Projeto Prático 3: Catálogo SPA Completo com Busca Debounced, Filtros e Rotas Dinâmicas

Módulo 6 • Lição 49 (Projeto Prático 3 • Penúltima Aula! • 98% do Curso • Pauta Satélite 394)

Projeto Prático 3: Catálogo SPA Completo com Busca Debounced, Filtros e Rotas Dinâmicas

Catálogos de mídia em larga escala (estilo Netflix, Spotify ou marketplaces) exigem uma experiência de usuário impecável: busca instantânea sem sobrecarga de rede, sincronização com parâmetros de rota, transições com skeletons e navegação profunda. Construa nesta penúltima lição uma SPA de Catálogo Multimídia completa em React.

1. Arquitetura da Solução & Desafios de Engenharia

Construir um catálogo reativo de alto desempenho envolve conectar múltiplos pilares que estudamos ao longo do curso:

  • Pesquisa Debounced com useDebounce: Evita o disparo prematuro de requisições a cada tecla digitada pelo usuário, aguardando 400ms de inatividade para filtrar os dados;
  • Sincronização de Estado na URL: O termo de busca e a categoria ativa são mantidos na query string para permitir o compartilhamento de links e manter o estado em recargas de tela (F5);
  • Feedback com Skeletons Reativos: Durante o tempo de resposta da busca assíncrona, a interface exibe skeletons que reproduzem a geometria exata dos cards, eliminando saltos de layout (Cumulative Layout Shift – CLS);
  • Rotas Dinâmicas para Detalhes: A seleção de qualquer título navega para a rota de detalhes dinâmicos (/catalogo/:id) via useParams, com botão de retorno preservando a busca anterior.

2. Implementação do Fluxo de Busca Debounced

Para que o input pareça 100% responsivo enquanto a busca aguarda a digitação terminar, mantemos um estado de digitação imediato (searchInput) e derivamos o valor filtrante através do custom hook useDebounce:

JavaScript 41 linhas
import { useState, useEffect, useMemo } from 'react';
import { useDebounce } from './useDebounce';
 
export function CatalogoContainer() {
    // 1. Estado bruto de digitação imediata no campo de texto
    const [searchTerm, setSearchTerm] = useState('');
    const [selectedCategory, setSelectedCategory] = useState('ALL');
    const [isLoading, setIsLoading] = useState(false);
 
    // 2. Valor debounced com atraso de 400ms
    const debouncedSearch = useDebounce(searchTerm, 400);
 
    // 3. Efeito simulando busca assíncrona ao mudar o termo debounced
    useEffect(() => {
        setIsLoading(true);
        const timer = setTimeout(() => {
            setIsLoading(false);
        }, 300); // Latência de resposta da API
        return () => clearTimeout(timer);
    }, [debouncedSearch, selectedCategory]);
 
    // 4. Filtragem memoizada com useMemo
    const filteredItems = useMemo(() => {
        return CATALOG_DATABASE.filter(item => {
            const matchesCategory = selectedCategory === 'ALL' || item.category === selectedCategory;
            const matchesText = item.title.toLowerCase().includes(debouncedSearch.toLowerCase());
            return matchesCategory && matchesText;
        });
    }, [debouncedSearch, selectedCategory]);
 
    return (
        <div>
            <input 
                value={searchTerm} 
                onChange={(e) => setSearchTerm(e.target.value)} 
                placeholder="Buscar filmes, documentários..." 
            />
            {isLoading ? <SkeletonGrid /> : <CardsGrid items={filteredItems} />}
        </div>
    );
}

3. Detalhes Dinâmicos & Sistema de Favoritos com LocalStorage

Ao selecionar um título do catálogo, a aplicação transiciona para a visualização detalhada capturando o parâmetro de rota via useParams(). O status de favorito é persistido no navegador:

JavaScript 30 linhas
import { useParams, useNavigate } from 'react-router-dom';
 
export function DetalheTitulo({ favoritos, toggleFavorito }) {
    const { id } = useParams();
    const navigate = useNavigate();
 
    const titulo = CATALOG_DATABASE.find(t => t.id === Number(id));
 
    if (!titulo) {
        return (
            <div className="not-found">
                <h3>Título não encontrado no catálogo.</h3>
                <button onClick={() => navigate('/catalogo')}>Voltar ao Catálogo</button>
            </div>
        );
    }
 
    const isFav = favoritos.includes(titulo.id);
 
    return (
        <article className="detalhe-hero">
            <button onClick={() => navigate(-1)}>&larr; Voltar</button>
            <h2>{titulo.title}</h2>
            <p>{titulo.synopsis}</p>
            <button onClick={() => toggleFavorito(titulo.id)}>
                {isFav ? '★ Salvo nos Favoritos' : '☆ Adicionar aos Favoritos'}
            </button>
        </article>
    );
}

4. Práticas Profissionais Aplicadas

  • Zero Jitter Visual: O uso de skeletons impede que elementos da página pulem de lugar enquanto a imagem ou texto é renderizado;
  • Controle de Rede: Em um backend real, o debounce de 400ms economiza milhares de chamadas redundantes a APIs pagas (como The Movie Database – TMDB ou Elasticsearch);
  • Acessibilidade & SEO: URLs canônicas limpas e títulos estruturados com tags semânticas (<article>, <nav>, <header>).

Laboratório Prático no Playground Web IDE

Experimente no editor abaixo a aplicação completa CineZone SPA! Digite no campo de busca para ver os skeletons reativos em ação, filtre por gêneros, clique nos cards para navegar até a tela de detalhes com useParams e gerencie sua lista de favoritos com persistência real!

🛠️ Laboratório Prático & Prática Imediata

Aplique o que você aprendeu nesta lição

Utilize nossas ferramentas online gratuitas para experimentar os conceitos ou teste o código ao vivo no Playground IDE.

💻 Desenvolvedor & Código

Editor de Códigos Web Online

Ambiente com destaque de sintaxe para você testar tags, tabelas e scripts na hora.

Abrir Ferramenta Online
⚡ Live Code Studio

Playground Web Online

Escreva seu código HTML, CSS ou JavaScript e veja o resultado renderizado ao vivo no navegador com zero configuração.

⚡ Codificar no Playground IDE
Foto de Web-Zoneware
✓ Verificado
🎓 Tutor & Coordenador da Web Academy

Web-Zoneware

Tutor Técnico & Desenvolvedor Full-Stack

Desenvolvedor web e instrutor focado na formação prática de novos programadores. Defensor ferrenho de código semântico, arquitetura limpa e acessibilidade W3C/WCAG, dedicando-se a construir cursos estruturados em metodologia passo a passo com execução ao vivo no Playground IDE.

Especialidades: HTML5 Semântico CSS3 & Flexbox/Grid JavaScript Moderno Acessibilidade WCAG 2.2 Didática Prática
Rolar para cima