JavaScript — As bases

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.

Resultado esperado :

Reproduzir uma realização funcional, testá-la e depois resolver um exercício sem copiar.

Leitura
0%

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.

python3 -m http.server 8080
A reter :

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.

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.

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
A reter :

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.

Attendu sans script :
- les trois recettes sont visibles ;
- le formulaire est caché ;
- aucun message d’erreur n’empêche de lire.
A reter :

É 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.

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.

<option value="15">15 minutes</option>
A reter :

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.

Objectif : recharger la page et retrouver la saisie précédente.
A reter :

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.

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"); }
});
A reter :

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.