mborroni / meme-of-the-day

project 3 @undefinedschool

Project 3: Meme Of The Day

Este es un proyecto para practicar e integrar lo visto sobre hacer requests usando Fetch API, Promises, manipulación del DOM, modularización, refactoring, Git y CSS.

Nota: trabajar en un branch dev y pushear a master(haciendo PR) cuando tengamos una feature completa, siguiendo el Feature Branch Workflow como metodología.

Parte 1: Request y procesamiento de los datos 🕵️‍♀️

0. Leer la documentación de la API de Memes
1. Crear un nuevo repo (no fork!) en GitHub para el código del ejercicio. Clonarlo para trabajar de forma local.
2. Dentro del repo, crear un archivo index.js, donde va a estar nuestro código.
3. Hacer un request de tipo GET al endpoint https://api.imgflip.com/get_memes, usando Fetch API.
4. Investigar el objeto Response. Si la respuesta es exitosa (status code: 200), mostrar en consola el mensaje "Successful request!", sino mostrar "Oops, we got an error ${STATUS_CODE}", con el valor correspondiente. Ver Handling Failed HTTP Responses With fetch()
5. A partir de la respuesta obtenida, generar el siguiente resultado:
   • Quedarnos sólo con las propiedades id, name, width, height y url (en ese orden) de cada elemento del array. Omitir el resto (Tip: usar destructuring). Ver ejemplo más abajo.
   • Generar un nuevo array de memes, donde cada uno tendrá las propiedades mencionadas en el ítem anterior
   • En este array, filtraremos aquellos elementos cuyas propiedades width ó height tengan un valor < 500
   • Ordenar el array por id, de forma ascendente
6. Mostrar el resultado en la consola. Recordá que podés usar console.dir para visualizar mejor objetos.
7. Usar siempre nombres declarativos para las variables, constantes, etc. Guía de buenas prácticas.
8. En caso de error al hacer el request, mostrar el message del error.

// resultado esperado
[
 {
   id: "93895088",
   name: "Expanding Brain",
   width: 857,
   height: 1202,
   url: "https://i.imgflip.com/1jwhww.jpg"
 },
 ...
]

Parte 2: Modularización y refactoring 🛀

Vamos a separar el código en 2 archivos, api.js y index.js. Usar ES6 Modules para exportar e importar entre ambos.

• api.js va a contener el código necesario para realizar el request a la API y retornar el array de memes original, sin modificaciones.
  • este código irá dentro de la función getMemes(URL), que recibe la url como parámetro
  • guardar el endpoint de la API en una constante global ENDPOINT
• index.js va a importar la función getMemes() de api.js, invocarla y hacer todo el procesamiento posterior que hicimos en la parte 1
  • modularizar los diferentes procesamientos que hacemos en los callbacks en funciones y usarlas. Ver abajo cómo debería quedar

do1()
  .then(do2())
  .then(do3());

Parte 3: Meme del día 📆

1. Escribir la función getMemeOfTheDay() (en index.js), que reciba un array de memes (resultado de la parte 2) y retorne el meme correspondiente al día actual, es decir, si hoy fuera 21 de Octubre, debe retornar el meme Nº 21 de la lista, mañana el Nº 22, etc.
2. Analizar posibilidades de modularizar y refactorizar esta función y aplicarlas.

Parte 4: Random! 🎰

1. Escribir la función getRandomMeme() (en index.js), que reciba un array de memes (resultado de la parte 2) y retorne, de forma aleatoria, algún meme del mismo.
2. Analizar posibilidades de modularizar y refactorizar esta función y aplicarlas.

Parte 5: Render 👀

1. Crear un index.html en el mismo repo, usando la estructura predefinida de un HTML5 vacío.
2. Crear dentro un div con la clase container.
   • Usar Flexbox para centrar (horizontal y verticalmente) todo el contenido de este div
   • Agregarle un h1 con el texto "Meme of the Day"
   • Agregarle debajo un tag img con la clase meme y asignarle como src el meme obtenido con la función getMemeOfTheDay()
   • Agregar un botón debajo del img, con la clase btn-get-random-meme y el texto "Get random Meme!"

Abajo se muestra cómo quedaría la estructura

  container
    |-- h1
    |-- img
    |-- button

3. Al hacer click en el botón, debe ocurrir lo siguiente:

• Modificar el texto del h1 a "Random Meme"
• Modificar el texto del botón a "Get another random Meme!"
• Utilizar la función getRandomMeme() de la parte 4 para obtener un meme aleatorio
  • Setear la url del meme random como src de la imagen obtenida
  • Setear el name del meme como random alt de la imagen obtenida

Parte 6: Estilizando 💅

1. Crear el archivo styles.css, donde irá todo el código que usaremos para los estilos.
2. Aplicar el reset con padding: 0, margin: 0 y box-sizing: border-box donde corresponda.
3. Usar fuentes de Google Fonts para los h1y h2.
4. Aplicar los estilos necesarios para que los elementos del container queden con la estructura y orden definidos en la parte 5.
5. Aplicar márgenes entre los diferentes elementos del container.
6. Agregar efectos y transiciones al botón, al hacerle hover y clickearlo.
7. Al hacer hover sobre la imagen del meme, se debe visualizar un texto con transición sobre la imagen, con el name del meme como texto. Ver texto con transición fade in como ejemplo.
8. Agregar todos los estilos que consideren necesarios

Parte 7: Hosting 🚀

Investigar cómo y hostear el proyecto usando

• GitHub Pages
• Now
• Netlify