Guia 03 / 4
Oficina de JavaScript · À table !
Permitir procurar uma receita pelo título e pela duração, apresentar o número de resultados e repor os filtros sem recarregar a página.
Reproduzir uma realização funcional, testá-la e depois resolver um exercício sem copiar.
01 · Ativar os filtros
O ficheiro completo app.js encontra-se no final da oficina.
Etapa 1 · Preparar os ficheiros
Conservar index.html e style.css, acrescentar app.js e a respetiva etiqueta script defer em head. Lançar o servidor a partir de mini-blog/ e abrir http://localhost:8080.
Exemplo
python3 -m http.server 8080
Se o Python não estiver disponível, utilizar o servidor local do editor. Resultado esperado: as três receitas e o formulário de filtros são visíveis.
Etapa 2 · Seguir uma filtragem
Digitar soupe. A introdução torna-se uma cadeia normalizada. O script percorre os três cartões, compara o título, modifica hidden e atualiza depois o contador.
Exemplo
Saisie : soupe
Attendu : Soupe de carottes uniquement, 1 recette affichée.
Etapa 3 · Testar os casos habituais
Testar cada cenário abaixo, repondo os filtros entre as tentativas. Comparar o número e os títulos, e não apenas o aspeto.
Exemplo
Vide + toutes durées → 3
SOUPE + toutes durées → 1
Vide + 20 minutes → soupe et salade, 2
tarte + 20 minutes → 0 et message d’aide
zzzz + toutes durées → 0 et message d’aide
Réinitialiser → 3
Estes resultados pressupõem as três receitas de referência; a compota opcional do curso de HTML acrescentaria um resultado.
Etapa 4 · Testar sem JavaScript
Desativar temporariamente a etiqueta script no HTML e recarregar a página. Reativar depois o script.
Exemplo
Attendu sans script :
- les trois recettes sont visibles ;
- le formulaire est caché ;
- aucun message d’erreur n’empêche de lire.
É a melhoria progressiva: o conteúdo já é útil antes das interações.
02 · Treinar sem copiar
Tentar antes de ler a solução.
Exercício · Acrescentar uma escolha de 15 minutos
Acrescentar uma opção 15 minutes no menu HTML, entre Toutes les durées e 20 minutes. O JavaScript não deve mudar.
Exemplo
Attendu avec les trois recettes de référence : seule Salade de tomates reste visible.
Solução · Fazer trabalhar os dados
Acrescentar esta opção em select#duree-max. Number e a comparação <= utilizam automaticamente o seu valor.
Exemplo
<option value="15">15 minutes</option>
Altera-se os dados propostos pelo HTML; a mesma função de filtragem trata o novo caso.
Exercício · Memorizar a última pesquisa, como prolongamento
Depois de os filtros funcionarem, experimentar conservar o texto pesquisado em localStorage. Trata-se de um armazenamento próprio do navegador e da origem do site, e não de uma base de dados partilhada.
Exemplo
Objectif : recharger la page et retrouver la saisie précédente.
Prolongamento facultativo. As definições de privacidade podem tornar o armazenamento indisponível; manter a filtragem utilizável.
Solução do prolongamento · Armazenamento local
Em app.js, inserir a leitura antes da primeira chamada final a filtrerRecettes. Acrescentar depois o ouvinte abaixo. try/catch impede que uma indisponibilidade do armazenamento estrague a página.
Exemplo
try {
recherche.value = localStorage.getItem("a-table-recherche") ?? "";
} catch (erreur) { console.info("Stockage indisponible"); }
recherche.addEventListener("input", () => {
try { localStorage.setItem("a-table-recherche", recherche.value); }
catch (erreur) { console.info("Stockage indisponible"); }
});
Este prolongamento memoriza apenas a introdução input; o botão reset de base não atualiza este valor guardado. Para um reset persistente, retirar a chave no respetivo ouvinte.