Bem-vindo a Documentação do Site de alimentos!
Visão Geral
Este documento descreve como implementar o protótipo do site de alimentos, que exibe informações nutricionais e históricas de pratos culinários.
Design
Uma barra de pesquisa para "Valor" (ex.: calorias ou outro filtro nutricional). Menus dropdown cinzas que expandem para mostrar detalhes do alimento, como nome, origem, valores nutricionais (energia, carboidratos, proteínas, gorduras, sódio) e histórico.
O site é responsivo, com um layout simples e clean, usando tons de verde (para o tema saudável) e cinza/bege para os elementos interativos. Assumimos uma stack web básica: HTML5, CSS3 e JavaScript vanilla (sem frameworks para simplicidade). Para dados, foi usado um array JSON local.
Objetivos funcionais: Permitir busca por alimentos via barra de pesquisa. Exibir cards expansíveis (dropdowns) com informações detalhadas. Tornar o site interativo: expandir/colapsar menus, filtrar resultados.
Passo a Passo: Como Usar o Site!
- Acessando o Site
Abra o navegador (Chrome, Firefox, Safari ou Edge). Digite o URL do site (ex.: http://localhost:5500/index.html se rodando localmente via Live Server, ou o domínio real quando hospedado). A página carrega com o header verde no topo, barra de busca abaixo e lista de cards de alimentos.
- Navegando pela Lista de Alimentos
Visualização Inicial: Os cards aparecem como menus cinzas compactos, mostrando apenas o nome do prato (ex.: "Estrogonofe").
Expandir um Card: Clique no cabeçalho cinza do card (o nome do prato).
O card expande suavemente para baixo, revelando:
Imagem do Prato: Foto ilustrativa. Nome e Região de Origem: Ex.: "Nome: Estrogonofe | Região: Rússia, Europa". Valores Nutricionais: Lista em grade (duas colunas no desktop, uma no mobile)
História: Parágrafo curto sobre a origem (ex.: explicações sobre a família Stroganov).
Para fechar: Clique novamente no cabeçalho cinza. O ícone de seta (▼) rotaciona para indicar o estado (aberto/fechado).
Rolagem na Lista: Se houver muitos pratos (ex.: 10+), use o mouse wheel, barra lateral ou toque (mobile) para rolar apenas a seção de alimentos. O header e a busca ficam fixos no topo.
- Usando a Barra de Pesquisa
Localização: Logo abaixo do header, um campo branco arredondado com placeholder "Valor (ex: calorias)". Como Pesquisar:
Digite um termo no campo:
Por Nome: Ex.: "estro" → Filtra para "Estrogonofe". Por Valor Nutricional: Ex.: "275" → Mostra pratos com energia próxima a isso. Combinações: Funciona para qualquer parte dos dados (nome, região, nutrientes).
Os resultados atualizam em tempo real (à medida que você digita). Para limpar: Clique no × ao lado do campo ou apague o texto manualmente.
- Dicas:
Pesquisas são case-insensitive (não diferencia maiúsculas/minúsculas). Se não houver resultados, a lista fica vazia — tente termos mais gerais. No mobile, o teclado aparece automaticamente ao tocar no campo.
Project layout
mkdocs.yml # The configuration file.
site-alimentos/
index.html # Página principal.
styles.css # Estilos globais.
script.js # Lógica interativa.
data/
alimentos.json # Dados dos alimentos (JSON).
assets/
images/
image.jpg # Imagem dos alimentos.
icons/
icon.svg # Favicon do site.