Projeto Prático 3: Catálogo SPA Completo com Busca Debounced, Filtros e Rotas Dinâmicas
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.
📑 Índice do Conteúdo
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) viauseParams, 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:
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:
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)}>← 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!
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.
Editor de Códigos Web Online
Ambiente com destaque de sintaxe para você testar tags, tabelas e scripts na hora.
Abrir Ferramenta OnlinePlayground 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