diff --git a/.vscode/settings.json b/.vscode/settings.json new file mode 100644 index 0000000..6b665aa --- /dev/null +++ b/.vscode/settings.json @@ -0,0 +1,3 @@ +{ + "liveServer.settings.port": 5501 +} diff --git a/Descripci%C3%B3n-del-proyecto b/Descripci%C3%B3n-del-proyecto new file mode 100644 index 0000000..e69de29 diff --git a/README.md b/README.md index a45b7d5..aed24d0 100644 --- a/README.md +++ b/README.md @@ -1,623 +1,94 @@ -# Data Lovers +![Imagen del header](./src/img/headerImg.png) -## Índice - -* [1. Preámbulo](#1-preámbulo) -* [2. Resumen del proyecto](#2-resumen-del-proyecto) -* [3. Objetivos de aprendizaje](#3-objetivos-de-aprendizaje) -* [4. Consideraciones generales](#4-consideraciones-generales) -* [5. Criterios de aceptación mínimos del proyecto](#5-criterios-de-aceptación-mínimos-del-proyecto) -* [6. Hacker edition](#6-hacker-edition) -* [7. Consideraciones técnicas](#7-consideraciones-técnicas) -* [8. Pistas, tips y lecturas complementarias](#8-pistas-tips-y-lecturas-complementarias) -* [9. Checklist](#9-checklist) - -*** - -## 1. Preámbulo - -Según [Forbes](https://www.forbes.com/sites/bernardmarr/2018/05/21/how-much-data-do-we-create-every-day-the-mind-blowing-stats-everyone-should-read), -el 90% de la data que existe hoy ha sido creada durante los últimos dos años. -Cada día generamos 2.5 millones de terabytes de datos, una cifra sin -precedentes. - -No obstante, los datos por sí mismos son de poca utilidad. Para que esas -grandes cantidades de datos se conviertan en **información** fácil de leer para -los usuarios, necesitamos entender y procesar estos datos. Una manera simple de -hacerlo es creando _interfaces_ y _visualizaciones_. - -En la siguiente imagen, podrás ver cómo con la data que que se ve en la parte -izquierda se puede construir una interfaz amigable y entendible por las -usuarias, al lado derecho. - -![pokemon-data-to-ui](https://user-images.githubusercontent.com/12631491/218505816-c6d11758-9de4-428f-affb-2a56ea4d68c4.png) - -## 2. Resumen del proyecto - -En este proyecto **construirás una _página web_ para visualizar un -_conjunto (set) de datos_** que se adecúe a lo que descubras que tu usuario -necesita. - -Como entregable final tendrás una página web que permita **visualizar la data, -filtrarla, ordenarla y hacer algún cálculo agregado**. Con cálculo agregado -nos referimos a distintos cálculos que puedes hacer con la data para mostrar -información aún más relevante para los usuarios (promedio, el valor máximo -o mínimo, etc). - -Esta vez te proponemos una serie de datos de diferentes _temáticas_ para que -explores y decidas con qué temática te interesa trabajar. Hemos elegido -específicamente estos sets de datos porque creemos que se adecúan bien a esta -etapa de tu aprendizaje. - -Una vez que definas tu área de interés, buscar entender quién es tu usuario -y qué necesita saber o ver exactamente; luego podrás construir la interfaz que -le ayude a interactuar y entender mejor esos datos. - -Estos son datos que te proponemos: - -* [Pokémon](src/data/pokemon/pokemon.json): - En este set encontrarás una lista con los 251 Pokémon de la región de Kanto - y Johto, junto con sus respectivas estadísticas usadas en el juego - [Pokémon GO](http://pokemongolive.com). - - [Investigación con jugadores de Pokémon Go](src/data/pokemon/README.md) - -* [League of Legends - Challenger leaderboard](src/data/lol/lol.json): - Este set de datos muestra la lista de campeones en una liga del - juego League of Legends (LoL). - - [Investigación con jugadores de LoL](src/data/lol/README.md) - -* [Rick and Morty](src/data/rickandmorty/rickandmorty.json). - Este set nos proporciona la lista de los personajes de la serie Rick and - Morty. [API Rick and Morty](https://rickandmortyapi.com). - - [Investigación con seguidores de Rick and Morty](src/data/rickandmorty/README.md) - -* [Juegos Olímpicos de Río de Janeiro](src/data/athletes/athletes.json). - Este set nos proporciona la lista de los atletas que ganaron medallas en las - olímpiadas de Río de Janeiro. - - [Investigación con interesados en juegos olímpicos de Río de Janeiro](src/data/athletes/README.md) - -* [Studio Ghibli](src/data/ghibli/ghibli.json). - En este set encontrarás una lista de las animaciones y sus personajes del - [Studio Ghibli](https://ghiblicollection.com/). - - [Investigación con seguidores de las animaciones del Studio Ghibli](src/data/ghibli/README.md) - -* [Harry Potter](src/data/harrypotter/harry.json). - En este set encontrarás una lista de los personajes,libros pociones - y hechizos de toda la saga de - [Harry Potter](https://harrypotter.fandom.com). - - [Investigación con seguidoras de Harry Potter](src/data/harrypotter/README.md) - -El objetivo principal de este proyecto es que aprendas a diseñar y construir una -interfaz web donde se pueda visualizar y manipular data, entendiendo lo que el -usuario necesita. - -## 3. Objetivos de aprendizaje - -Reflexiona y luego marca los objetivos que has llegado a entender y aplicar en tu proyecto. Piensa en eso al decidir tu estrategia de trabajo. - -### HTML - -- [ ] **Uso de HTML semántico** - -
Links

- - * [HTML semántico](https://curriculum.laboratoria.la/es/topics/html/02-html5/02-semantic-html) - * [Semantics - MDN Web Docs Glossary](https://developer.mozilla.org/en-US/docs/Glossary/Semantics#Semantics_in_HTML) -

- -### CSS - -- [ ] **Uso de selectores de CSS** - -
Links

- - * [Intro a CSS](https://curriculum.laboratoria.la/es/topics/css/01-css/01-intro-css) - * [CSS Selectors - MDN](https://developer.mozilla.org/es/docs/Web/CSS/CSS_Selectors) -

- -- [ ] **Modelo de caja (box model): borde, margen, padding** - -
Links

- - * [Box Model & Display](https://curriculum.laboratoria.la/es/topics/css/01-css/02-boxmodel-and-display) - * [The box model - MDN](https://developer.mozilla.org/en-US/docs/Learn/CSS/Building_blocks/The_box_model) - * [Introduction to the CSS box model - MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_Box_Model/Introduction_to_the_CSS_box_model) - * [CSS display - MDN](https://developer.mozilla.org/pt-BR/docs/Web/CSS/display) - * [display - CSS Tricks](https://css-tricks.com/almanac/properties/d/display/) -

- -- [ ] **Uso de flexbox en CSS** - -
Links

- - * [A Complete Guide to Flexbox - CSS Tricks](https://css-tricks.com/snippets/css/a-guide-to-flexbox/) - * [Flexbox Froggy](https://flexboxfroggy.com/#es) - * [Flexbox - MDN](https://developer.mozilla.org/en-US/docs/Learn/CSS/CSS_layout/Flexbox) -

- -### Web APIs - -- [ ] **Uso de selectores del DOM** - -
Links

- - * [Manipulación del DOM](https://curriculum.laboratoria.la/es/topics/browser/02-dom/03-1-dom-methods-selection) - * [Introducción al DOM - MDN](https://developer.mozilla.org/es/docs/Web/API/Document_Object_Model/Introduction) - * [Localizando elementos DOM usando selectores - MDN](https://developer.mozilla.org/es/docs/Web/API/Document_object_model/Locating_DOM_elements_using_selectors) -

- -- [ ] **Manejo de eventos del DOM (listeners, propagación, delegación)** - -
Links

- - * [Introducción a eventos - MDN](https://developer.mozilla.org/es/docs/Learn/JavaScript/Building_blocks/Events) - * [EventTarget.addEventListener() - MDN](https://developer.mozilla.org/es/docs/Web/API/EventTarget/addEventListener) - * [EventTarget.removeEventListener() - MDN](https://developer.mozilla.org/es/docs/Web/API/EventTarget/removeEventListener) - * [El objeto Event](https://developer.mozilla.org/es/docs/Web/API/Event) -

+# DATA LOVERS ("POKEDEX") -- [ ] **Manipulación dinámica del DOM** +--- -
Links

- - * [Introducción al DOM](https://developer.mozilla.org/es/docs/Web/API/Document_Object_Model/Introduction) - * [Node.appendChild() - MDN](https://developer.mozilla.org/es/docs/Web/API/Node/appendChild) - * [Document.createElement() - MDN](https://developer.mozilla.org/es/docs/Web/API/Document/createElement) - * [Document.createTextNode()](https://developer.mozilla.org/es/docs/Web/API/Document/createTextNode) - * [Element.innerHTML - MDN](https://developer.mozilla.org/es/docs/Web/API/Element/innerHTML) - * [Node.textContent - MDN](https://developer.mozilla.org/es/docs/Web/API/Node/textContent) -

- -### JavaScript - -- [ ] **Diferenciar entre tipos de datos primitivos y no primitivos** - -- [ ] **Arrays (arreglos)** - -
Links

- - * [Arreglos](https://curriculum.laboratoria.la/es/topics/javascript/04-arrays) - * [Array - MDN](https://developer.mozilla.org/es/docs/Web/JavaScript/Reference/Global_Objects/Array/) - * [Array.prototype.sort() - MDN](https://developer.mozilla.org/es/docs/Web/JavaScript/Reference/Global_Objects/Array/sort) - * [Array.prototype.forEach() - MDN](https://developer.mozilla.org/es/docs/Web/JavaScript/Reference/Global_Objects/Array/forEach) - * [Array.prototype.map() - MDN](https://developer.mozilla.org/es/docs/Web/JavaScript/Reference/Global_Objects/Array/map) - * [Array.prototype.filter() - MDN](https://developer.mozilla.org/es/docs/Web/JavaScript/Reference/Global_Objects/Array/filter) - * [Array.prototype.reduce() - MDN](https://developer.mozilla.org/es/docs/Web/JavaScript/Reference/Global_Objects/Array/Reduce) -

- -- [ ] **Objetos (key, value)** - -
Links

- - * [Objetos en JavaScript](https://curriculum.laboratoria.la/es/topics/javascript/05-objects/01-objects) -

- -- [ ] **Variables (declaración, asignación, ámbito)** - -
Links

- - * [Valores, tipos de datos y operadores](https://curriculum.laboratoria.la/es/topics/javascript/01-basics/01-values-variables-and-types) - * [Variables](https://curriculum.laboratoria.la/es/topics/javascript/01-basics/02-variables) -

- -- [ ] **Uso de condicionales (if-else, switch, operador ternario, lógica booleana)** - -
Links

- - * [Estructuras condicionales y repetitivas](https://curriculum.laboratoria.la/es/topics/javascript/02-flow-control/01-conditionals-and-loops) - * [Tomando decisiones en tu código — condicionales - MDN](https://developer.mozilla.org/es/docs/Learn/JavaScript/Building_blocks/conditionals) -

- -- [ ] **Uso de bucles/ciclos (while, for, for..of)** - -
Links

- - * [Bucles (Loops)](https://curriculum.laboratoria.la/es/topics/javascript/02-flow-control/02-loops) - * [Bucles e iteración - MDN](https://developer.mozilla.org/es/docs/Web/JavaScript/Guide/Loops_and_iteration) -

- -- [ ] **Funciones (params, args, return)** - -
Links

- - * [Funciones (control de flujo)](https://curriculum.laboratoria.la/es/topics/javascript/02-flow-control/03-functions) - * [Funciones clásicas](https://curriculum.laboratoria.la/es/topics/javascript/03-functions/01-classic) - * [Arrow Functions](https://curriculum.laboratoria.la/es/topics/javascript/03-functions/02-arrow) - * [Funciones — bloques de código reutilizables - MDN](https://developer.mozilla.org/es/docs/Learn/JavaScript/Building_blocks/Functions) -

- -- [ ] **Pruebas unitarias (unit tests)** - -
Links

- - * [Empezando con Jest - Documentación oficial](https://jestjs.io/docs/es-ES/getting-started) -

- -- [ ] **Módulos de ECMAScript (ES Modules)** - -
Links

- - * [import - MDN](https://developer.mozilla.org/es/docs/Web/JavaScript/Reference/Statements/import) - * [export - MDN](https://developer.mozilla.org/es/docs/Web/JavaScript/Reference/Statements/export) -

- -- [ ] **Uso de linter (ESLINT)** - -- [ ] **Uso de identificadores descriptivos (Nomenclatura y Semántica)** - -- [ ] **Diferenciar entre expresiones (expressions) y sentencias (statements)** - -### Control de Versiones (Git y GitHub) - -- [ ] **Git: Instalación y configuración** - -- [ ] **Git: Control de versiones con git (init, clone, add, commit, status, push, pull, remote)** - -- [ ] **Git: Integración de cambios entre ramas (branch, checkout, fetch, merge, reset, rebase, tag)** - -- [ ] **GitHub: Creación de cuenta y repos, configuración de llaves SSH** - -- [ ] **GitHub: Despliegue con GitHub Pages** - -
Links

- - * [Sitio oficial de GitHub Pages](https://pages.github.com/) -

- -- [ ] **GitHub: Colaboración en Github (branches | forks | pull requests | code review | tags)** - -### Centrado en el usuario - -- [ ] **Diseñar y desarrollar un producto o servicio poniendo a las usuarias en el centro** - -### Diseño de producto +## Índice -- [ ] **Crear prototipos de alta fidelidad que incluyan interacciones** +* [Descripción del Proyecto](Descripción-del-proyecto) +* [Objetivo de la página](objetivo-de-la-página) +* [Usuario objetivo](Usuario-objetivo) +* [Necesidad del usuario](necesidad-del-usuario) +* [Historias de usuario](historias-de-usuario) +* [Diseño de la interfaz de Usuario](Diseño-de-la-interfaz-de-Usuario) +* [Prototipo de baja fidelidad](Prototipo-de-baja-fidelidad) +* [Prototipo de alta fidelidad](Prototipo-de-alta-fidelidad) +* [Responsive](responsive) +* [Responsive smartphone](Responsive-smartphones) +* [Responsive tablet](Responsive-tablet) +* [Link de Figma](link-de-figma) +* [Link de Github-Pages](link-de-Github-Pages) -- [ ] **Seguir los principios básicos de diseño visual** +--- -### Investigación +## 1. Descripción del Proyecto: -- [ ] **Planear y ejecutar testeos de usabilidad de prototipos en distintos niveles de fidelidad** +![vista1Figma](https://github.com/LadyDi3103/DEV005-data-lovers/blob/main/src/img/figmaImg1.png?raw=true) ![VISTA2-Proyecto](https://github.com/LadyDi3103/DEV005-data-lovers/blob/main/src/img/figmaImg2.png?raw=true) -
Links

+Data Lovers ("Pokedex"), es una aplicación web que permite al usuario visualizar la data de 251 pokemones, asi como tambien, y podrá ordenar la data de forma ascedente (A-Z) y descendente (Z-A), filtrar por tipo de pokemones (Acero, Agua, Bicho, Dragon, Eléctrico, Fantasma, Fuego, Hada, Hielo, Lucha, Normal, Planta, Psíquico, Roca, Siniestro, Tierra y Volador), y podrá filtrar por nombre al pokémon de su elección. - * [Intro a testeos usabilidad](https://coda.io/@bootcamp-laboratoria/contenido-ux/test-de-usabilidad-15) - * [Pruebas con Usuarios 1 — ¿Qué, cuándo y para qué testeamos?](https://eugeniacasabona.medium.com/pruebas-con-usuarios-1-qu%C3%A9-cu%C3%A1ndo-y-para-qu%C3%A9-testeamos-7c3a89b4b5e7) -

+"Pokedex", es una web responsive e intuitiva para el usuario ya que no hay necesidad de seguir instrucciones y esto le permitirá acceder e interactuar con toda la información que contiene. -## 4. Consideraciones generales +## 2. Objetivo de la página -* Este proyecto se debe resolver en duplas. -* El rango de tiempo estimado para completar el proyecto es de 3 a 4 Sprints. -* El proyecto será entregado subiendo tu código a GitHub (commit/push) y la - interfaz será desplegada usando [GitHub Pages](https://pages.github.com/). +*Permitir* al usuario encontrar e interactuar para encontrar información útil, mediante diferentes ordenamientos, filtros por tipo y/ o búsqueda por nombre de pokémon. -## 5. Criterios de aceptación mínimos del proyecto +## 3. Usuario Objetivo -Los criterios para considerar que has completado este proyecto son: +Toda persona aficionada o fan de los **pokémones** que desee información precisa, filtrada por tipos de pokémon u ordenada sobre algún pokémon en específico o várias criaturas en comúm. -### Definición del producto +## 4. Necesidad del usuario -Documenta brevemente tu trabajo en el archivo `README.md` de tu repositorio, -contándonos cómo fue tu proceso de diseño y cómo crees que el producto resuelve -el problema (o problemas) que tiene tu usuario. +Se encontró un déficit de páginas intuitivas enfocadas exclusivamente a las características de los pokémones y las existentes son de difícil acceso y no es intuitivo. -### Historias de usuario +## 5. Historias de usuario -Una vez que entiendas las necesidades de tus usuarios, escribe las [Historias -de Usuario](https://es.wikipedia.org/wiki/Historias_de_usuario) que representen -todo lo que el usuario necesita hacer/ver. Las **Historias de Usuario** deben -ser el resultado de tu proceso de investigación o _research_ de tus usuarios. +**Historia de usuario 1** -Asegúrate de incluir la definición de terminado (_definition of done_) y los -Criterios de Aceptación para cada una. +* YO como usuario (En la vista 1) quiero ver una interfaz de bienvenida y en otra vista (vista 2) ver todas las imágenes de los pokemones con sus respectivos nombres, hp, tipo y número de orden. -En la medida de lo posible, termina una historia de usuario antes de pasar -a la siguiente (Cumple con Definición de Terminado + Criterios de Aceptación). +**Historia de usuario 2** -### Diseño de la Interfaz de Usuario +* YO como usuario quiero poder ORDENAR los **Cards de POKÉMON** de la (A-Z & Z-A) y tener un menú desplegable. -#### Prototipo de baja fidelidad +**Historia de usuario 3** -Durante tu trabajo deberás haber hecho e iterado bocetos (_sketches_) de tu -solución usando papel y lápiz. Te recomendamos tomar fotos de todas las -iteraciones que hagas, que las subas a tu repositorio y las menciones en tu -`README.md`. +* YO como usuario quiero poder FILTRAR por tipo y por nombre los **Cards de POKÉMON**. -#### Prototipo de alta fidelidad +**Historia de usuario 4** -Lo siguiente es diseñar tu Interfaz de Usuario (UI por sus siglas en inglés - -_User Interface_). Para eso debes aprender a utilizar alguna herramienta de -diseño visual. Nosotros te recomendamos [Figma](https://www.figma.com/) que es -una herramienta que funciona en el navegador y, además, puedes crear una cuenta -gratis. Sin embargo, eres libre de utilizar otros editores gráficos como -Illustrator, Photoshop, PowerPoint, Keynote, etc. +* YO como usuario quiero acceder a una página responsive y que se muestre el porcentaje de **Cards de POKÉMON** mostrados en pantalla. -El diseño debe representar el _ideal_ de tu solución. Digamos que es lo que -desearías implementar si tuvieras tiempo ilimitado para trabajar. Además, tu -diseño debe seguir los fundamentos de _visual design_. +## 6. Diseño de la interfaz de Usuario -#### Testeos de usabilidad +### Prototipo de baja fidelidad -Durante el reto deberás hacer _tests_ de usabilidad con distintos usuarios, y -en base a los resultados, deberás iterar tus diseños. Cuéntanos -qué problemas de usabilidad detectaste a través de los _tests_ y cómo los -mejoraste en tu propuesta final. +Nuestro primer acercamiento a la aplicación Web, se basó en el desplazamiento de la información que contendrá esta misma, además de los elementos que la componen. Boceteamos en papel y lápiz nuestras ideas iniciales. Nos pusimos de acuerdo en un diseño y lo plasmamos nuevamente: -### Implementación de la Interfaz de Usuario (HTML/CSS/JS) +![pokemon-logo.gif](https://github.com/LadyDi3103/DEV005-data-lovers/blob/main/src/img/BajaFidelidad.png?raw=true) -Luego de diseñar tu interfaz de usuario deberás trabajar en su implementación. -**No** es necesario que construyas la interfaz exactamente como la diseñaste. -Tu tiempo de hacking es escaso, así que deberás priorizar +### Prototipo de alta fidelidad -Como mínimo, tu implementación debe: +Usamos Figma como herramienta de diseño visual. -1. Mostrar la data en una interfaz: puede ser un card, una tabla, una lista, - etc. -2. Permitir al usuario interactuar para obtener la infomación que necesita. -3. Ser _responsive_, es decir, debe visualizarse sin problemas desde distintos - tamaños de pantallas: móviles, tablets y desktops. -4. Que la interfaz siga los fundamentos de _visual design_. +![vista1Figma](https://github.com/LadyDi3103/DEV005-data-lovers/blob/main/src/img/figmaImg1.png?raw=true) +![vista2Figma](https://github.com/LadyDi3103/DEV005-data-lovers/blob/main/src/img/figmaImg2.png?raw=true) +![FiltradoxtipoFigma](https://github.com/LadyDi3103/DEV005-data-lovers/blob/main/src/img/figmaImg5.png?raw=true) +![vista6Figma](https://github.com/LadyDi3103/DEV005-data-lovers/blob/main/src/img/figmaImg6.png?raw=true) -### Pruebas unitarias +### Responsive -El _boilerplate_ de este proyecto no incluye Pruebas Unitarias (_tests_), así es -que tendrás que escribirlas tú para las funciones encargadas de _procesar_, -_filtrar_ y _ordenar_ la data, así como _calcular_ estadísticas. +#### Smartphone -Tus _pruebas unitarias_ deben dar una cobertura del 70% de _statements_ -(_sentencias_), _functions_ (_funciones_), _lines_ (_líneas_), y _branches_ -(_ramas_) del archivo `src/data.js` que contenga tus funciones y está detallado -en la sección de [Consideraciones técnicas](#srcdatajs). +![pokemon-logo.gif](https://github.com/LadyDi3103/DEV005-data-lovers/blob/main/src/img/mobile%20(1).png?raw=true) +![pokemon-logo.gif](https://github.com/LadyDi3103/DEV005-data-lovers/blob/main/src/img/mobile%20(2).png?raw=true) -## 6. Hacker edition +#### Tablet -Las secciones llamadas _Hacker Edition_ son **opcionales**. Si **terminaste** -con todo lo anterior y te queda tiempo, intenta completarlas. Así podrás -profundizar y/o ejercitar más sobre los objetivos de aprendizaje del proyecto. +![pokemon-logo.gif](https://github.com/LadyDi3103/DEV005-data-lovers/blob/main/src/img/tablet%20(1).png?raw=true) +![pokemon-logo.gif](https://github.com/LadyDi3103/DEV005-data-lovers/blob/main/src/img/tablet%20(2).png?raw=true) -Features/características extra sugeridas: +#### [Link de Figma:](https://www.figma.com/file/pt6yJwDvdJsEKaHKqG4DkH/Data-Lovers?node-id=0-1&t=8dtdEZM24kI5VPFh-0) -* En lugar de consumir la data estática brindada en este repositorio, puedes - consumir la data de forma dinámica, cargando un archivo JSON por medio de - `fetch`. La carpeta `src/data` contiene una versión `.js` y una `.json` de - de cada set datos. -* Agregarle a tu interfaz de usuario implementada visualizaciones gráficas. Para - ello te recomendamos explorar librerías de gráficas como - [Chart.js](https://www.chartjs.org/) - o [Google Charts](https://developers.google.com/chart/). -* 100% Coverage - -## 7. Consideraciones técnicas - -La lógica del proyecto debe estar implementada completamente en JavaScript -(ES6), HTML y CSS. En este proyecto NO está permitido usar librerías o -frameworks, solo [vanilla JavaScript](https://medium.com/laboratoria-how-to/vanillajs-vs-jquery-31e623bbd46e), -con la excepción de librerías para hacer gráficas (charts); ver -[_Parte opcional_](#6-hacker-edition) más arriba. - -El _boilerplate_ contiene una estructura de archivos como punto de partida así -como toda la configuración de dependencias: - -```text -. -├── EXTRA.md -├── README.md -├── package.json -├── src -| ├── data (según con qué data trabajes) -| | ├── lol -| | | ├── lol.js -| | | ├── lol.json -| | | └── README.md -| | ├── pokemon -| | | ├── pokemon.js -| | | ├── pokemon.json -| | | └── README.md -| | └── rickandmorty -| | | ├── rickandmorty.js -| | | ├── rickandmorty.json -| | | └── README.md -| | └── athletes -| | | ├── athletes.js -| | | ├── athletes.json -| | | └── README.md -| | └── ghibli -| | | ├── ghibli.js -| | | ├── ghibli.json -| | | └── README.md -| ├── data.js -| ├── index.html -| ├── main.js -| └── style.css -└── test - └── data.spec.js - -directory: 7 file: 20 -``` - -### `src/index.html` - -Como en el proyecto anterior, existe un archivo `index.html`. Como ya sabes, -acá va la página que se mostrará al usuario. También nos sirve para indicar -qué scripts se usarán y unir todo lo que hemos hecho. - -### `src/main.js` - -Recomendamos usar `src/main.js` para todo tu código que tenga que ver con -mostrar los datos en la pantalla. Con esto nos referimos básicamente a la -interacción con el DOM. Operaciones como creación de nodos, registro de -manejadores de eventos (_event listeners_ o _event handlers_), .... - -Esta no es la única forma de dividir tu código, puedes usar más archivos y -carpetas, siempre y cuando la estructura sea clara para tus compañeras. - -En este archivo encontrarás una serie de _imports_ _comentados_. Para _cargar_ -las diferentes fuentes de datos tendrás que _descomentar_ la línea -correspondiente. - -Por ejemplo, si "descomentamos" la siguiente línea: - -```js -// import data from './data/lol/lol.js'; -``` - -La línea quedaría así: - -```js -import data from './data/lol/lol.js'; -``` - -Y ahora tendríamos la variable `data` disponible en el script `src/main.js`. - -### `src/data.js` - -El corazón de este proyecto es la manipulación de datos a través de arreglos -y objetos. - -Te recomendamos que este archivo contenga toda la funcionalidad que corresponda -a obtener, procesar y manipular datos (tus funciones). Por ejemplo: - -* `filterData(data, condition)`: esta función `filter` o filtrar recibiría la - data, y nos retornaría aquellos datos que sí cumplan con la condición. - -* `sortData(data, sortBy, sortOrder)`: esta función `sort` u ordenar - recibe tres parámetros. - El primer parámetro, `data`, nos entrega los datos. - El segundo parámetro, `sortBy`, nos dice con respecto a cuál de los campos de - la data se quiere ordenar. - El tercer parámetro, `sortOrder`, indica si se quiere ordenar de manera - ascendente o descendente. - -* `computeStats(data)`: la función `compute` o calcular, nos permitirá hacer - cálculos estadísticos básicos para ser mostrados de acuerdo a la data - proporcionada. - -Estos nombres de funciones y de parámetros son solamente referenciales, lo que -decidas depende de tu propia implementación. - -Estas funciones deben ser [_puras_](https://medium.com/laboratoria-developers/introducci%C3%B3n-a-la-programaci%C3%B3n-funcional-en-javascript-parte-2-funciones-puras-b99e08c2895d) -e independientes del DOM. Estas funciones serán después usadas desde el archivo -`src/main.js`, al cargar la página, y cada vez que el usuario interactúe (click, -filtrado, ordenado, ...). - -### `src/data` - -En esta carpeta están los datos de las diferentes fuentes. Encontrarás una -carpeta por cada fuente, y dentro de cada carpeta dos archivos: uno con la -extensión `.js` y otro `.json`. Ambos archivos contienen la misma data; la -diferencia es que el `.js` lo usaremos a través de una etiqueta ` - + \ No newline at end of file diff --git a/src/main.js b/src/main.js index 71c59f2..dba8dcb 100644 --- a/src/main.js +++ b/src/main.js @@ -1,6 +1,73 @@ -import { example } from './data.js'; -// import data from './data/lol/lol.js'; + import data from './data/pokemon/pokemon.js'; -// import data from './data/rickandmorty/rickandmorty.js'; +import {sortData,filtrar,filtrar1, calcular} from "./data.js"; + +const pokemones = data.pokemon; + +const headerHtml = document.getElementById("headerHtml"); +headerHtml.style.display = "none"; + +const section0 = document.getElementById("section0"); +const container = document.getElementById("contieneTodosLosPokemones"); +container.style.display = "none"; + +const btnEmpezar = document.getElementById("empezar"); +btnEmpezar.addEventListener("click",()=>{ + section0.style.display = "none"; + container.style.display = "grid"; + headerHtml.style.display = "block"; +}); + +section0.style.display = "block"; -console.log(example, data); +// Pinta cards de POKEMONES +function pintar(data){ + let todos = ''; + for (let i = 0; i < data.length; i++){ + todos += ` +
+

HP ${data[i].stats["max-hp"]}

+Imágenes de Pokemones +

${data[i].name.toUpperCase()}

+

Nº ${data[i].num}

+

${data[i].type}

+
+ ` + } + document.getElementById('contieneTodosLosPokemones').innerHTML = todos; +} +pintar(pokemones); +calcular(pokemones); +//Ordenar pokemon de la (A-Z)&(Z-A) +document.getElementById("ordenar").addEventListener("change", (event) => { + const option = event.target.value; + if (option === "TODOS") { + pintar(pokemones); + calcular(pokemones); + } else if (option === "A-Z") { + const resultadoAZ = sortData(pokemones); + pintar(resultadoAZ); + calcular(resultadoAZ); + } else { + const resultadoZA = sortData(pokemones); + pintar(resultadoZA.reverse()); + calcular(resultadoZA); + } +}); +//Filtrar pokemon por tipo +document.getElementById("tipo").addEventListener("change", (event) => { + const optionType = event.target.value; + const filtrado = filtrar(pokemones, optionType); + pintar(filtrado); + calcular(filtrado); +}); +//Buscar pokemon por Nombre +document.getElementById("searchPokemones").addEventListener("change", (event) => { + const filtroName = event.target.value; + const filtrado = filtrar1(pokemones, filtroName); + pintar (filtrado); + calcular(filtrado); + if (filtroName.length === "0") { + alert("No se encontraron resultados"); + } +}); diff --git a/src/style.css b/src/style.css index e69de29..7348b9a 100644 --- a/src/style.css +++ b/src/style.css @@ -0,0 +1,565 @@ +@import url('https://fonts.googleapis.com/css2?family=Alkatra:wght@500&display=swap'); +html { + box-sizing: border-box; + font-size: 62.5%; +} +*, +*:before, +*:after { + box-sizing: inherit; +} + #header { + text-align: center; + } + #imgNavBar { + width: 100%; + height: 300px; + } + #searchPokemones { + margin: 20px; + justify-content: center; + } + #empezar { + border: 1px solid black; + border-radius: 8px; + padding: 1px 1em; + background: #0573C0; + color: rgb(249, 248, 248); + font-family: monospace; + font-size: 150%; + font-weight: 600; + text-decoration: none; + width: 20%; + text-align: center; + height: 55px; + margin-bottom: 6%; + } + .buscador { + width: 30%; + opacity:4; + text-align:center; + font-size: 150%; + height: 45px; + margin-top: 8px; + margin-bottom: 7px; + justify-content: center; + align-content: center; + gap: 30px; + border: 1px solid black; + border-radius: 8px; + } + .label{ + font-size: 100%; + } + #buscar { + background-color: rgb(220, 218, 218); + width: 8%; + height: 31px; + border-radius: 7px; + font-size: medium; + } + #textoCalc { + text-align: center; + font-family: Alkatra; + font-size: 180%; + font-weight: 500; + } + body { + background-image: url(img/WhatsApp\ Image\ 2023-03-05\ at\ 12.30.57.jpeg); + background-repeat: no-repeat; + background-attachment: fixed; + background-size: cover; + margin: 0; + display: flex; + flex-direction: column; + min-height: 100vh; + } + #searchPokemones { + margin: 20px; + justify-content: center; + } + header { + margin-top: 20px; + display: inline-flex; + width: -webkit-fill-available; + } + #contieneTodosLosPokemones { + display: grid; + grid-template-columns: repeat(5, 1fr); + grid-gap: 50px; + margin: 3%; + } + .Cards { + background: radial-gradient(circle at 50% 0%, orange 36%, #ffffff 36%); + width: 90%; + padding: 30px 20px; + box-shadow: 0 20px 30px rgba(0, 0, 0, 0.15); + border-radius: 10px; + border: 1px solid black; + display: flex; + flex-direction: column; + align-items: center; + } + .imgCard { + display: block; + width: 200px; + max-height: 200px; + position: relative; + margin: 20px auto; + size: 150px; + } + + .hp { + width: 80px; + background-color: #ffffff; + text-align: center; + padding: 8px 0; + border-radius: 30px; + margin-left: auto; + font-weight: 700; + font-size: initial; + } + + .poke-name { + text-align: center; + font-weight: 600; + font-size: medium; + } + + .types { + display: flex; + justify-content: space-around; + font-size: large; + } + + .hp span, + .types span { + font-size: 12px; + letter-spacing: 0.4px; + font-weight: 600; + } + .stats { + display: flex; + align-items: center; + justify-content: space-between; + text-align: center; + } + .stats p { + color: #404060; + } + .Cards > article { + margin: 20px; + } + .poke-number { + text-align: center; + font-size: medium; + } + table > * { + text-align: center; + font-family: 'Cookie', cursive; + font-size: xx-large ; + margin: 0 auto; + padding: 10px 20px; + width: 100%; + display: table; + } + #letra{ + text-align: center; + font-family: Alkatra; + font-size: 150%; + font-weight: 400; + + } + table > h1{ + font-family: Alkatra; + font-weight: 600; + } + #logoVista1 { + width: 100%; + height: 250px; + } + .label { + font-size: 150%; + font-weight: 700; + } + .botones { + border: 1px solid black; + border-radius: 8px; + padding: 1px 1em; + background-color:#0573C0; + color: rgb(249, 248, 248); + font-family: monospace; + font-size: 200%; + font-weight: 600; + text-decoration: none; + display: inline-block; + width: 15%; + text-align: center; + height: 45px; + } + .pokebolaGift { + width: 30px; + height: 30px; + } + #gifPokebolas{ + display: flex; + width: 100%; + justify-content: space-around; + } + #gifPikachu { + display: flex; + width: 50%; + justify-content:end; + } + #contenedorImgTable{ + display: flex; + align-items: flex-end; + justify-content: space-between; + width: 100%; + /* bottom: 43px; */ + } + footer{ + text-align: center; + font-family: sans-serif; + font-weight: 300px; + bottom: 0; + width: 100%; + color:#F5EB6D ; + margin-top: auto; + } + #contenedorFooter { + background-image: url(img/noche-estrellada.gif); + background-position: center; + text-align: center; + color: white; + font-size: 17px; + font-family: monospace; + font-weight: 700; + padding: 14px; + } + + p{ + margin: 0; + } +/* + ##Device = Desktops (Escritorio) + ##Screen = 1366px pantallas de escritorio de alta resolución +*/ +@media (max-width: 1366px) { + /* Vista 1 */ + #logoVista1 { + width: 100%; + height: 234px; +} + #letra { + text-align: center; + font-family: Alkatra; + font-size: 100%; + font-weight: 400; +} +#empezar { + border: 1px solid black; + border-radius: 8px; + padding: 1px 1em; + background: #0573C0; + color: rgb(249, 248, 248); + font-family: monospace; + font-size: 130%; + font-weight: 600; + text-decoration: none; + width: 20%; + text-align: center; + height: 55px; + margin-bottom: 8%; +} + #gifPokebolas { + display: flex; + width: 100%; + justify-content: around; +} +.botones { + border: 1px solid black; + border-radius: 8px; + padding: 1px 1em; + background-color:#0573C0; + color: rgb(249, 248, 248); + font-family: monospace; + font-size: 200%; + font-weight: 600; + text-decoration: none; + display: inline-block; + width: 15%; + text-align: center; + height: 45px; +} +/* Vista 2 */ +#imgNavBar { + width: 100%; + height: 215px; + margin-top: -2%; +} +#buscar { + background-color: rgb(220, 218, 218); + width: 8%; + height: 31px; + border-radius: 7px; + font-size: medium; +} +#textoCalc { + text-align: center; + font-family: Alkatra; + font-size: 180%; + font-weight: 500; +} +#contieneTodosLosPokemones { + display: grid; + grid-template-columns: repeat(4, 1fr); + grid-gap: 50px; + margin: 1%; +} +.label { + font-size: 150%; + font-weight: 700; +} +} + +/* + ##Device = Tablets, Ipads (portrait/Vertical) + ##Screen = 1024px +*/ +@media (max-width: 1024px) { + /* Vista 1 */ + #letra{ + text-align: center; + font-family: Alkatra; + font-size: 100%; + font-weight: 400; + } + #empezar { + border: 1px solid black; + border-radius: 7px; + padding: 1px 1em; + background: #0573C0; + color: rgb(249, 248, 248); + font-family: monospace; + font-size: 100%; + font-weight: 600; + text-decoration: none; + width: 20%; + text-align: center; + height: 50px; + margin-bottom: 7%; +} +#gifPokebolas { + display: flex; + width: 100%; + justify-content: space-around; +} +#imagenGif { + width: 80%; +} +/* Vista 2 */ +.botones { + border: 1px solid black; + border-radius: 8px; + padding: 1px 1em; + background-color: #0573C0; + color: rgb(249, 248, 248); + font-family: monospace; + font-size: 210%; + font-weight: 600; + text-decoration: none; + display: inline-block; + width: 35%; + text-align: center; + height: 30px; + margin-top: 2%; +} +.buscador { + width: 50%; + opacity: 4; + text-align: center; + font-size: 170%; + height: 30px; + margin-top: 8px; + margin-bottom: 7px; + justify-content: center; + align-content: center; + gap: 30px; + border: 1px solid black; + border-radius: 7px; +} +#buscar { + background-color: rgb(220, 218, 218); + width: 14%; + height: 25px; + border-radius: 7px; + font-size: 180%; +} +#textoCalc { + text-align: center; + font-family: Alkatra; + font-size: 180%; + font-weight: 550; +} +.label { + font-size: 150%; + font-weight: 700; +} +#contieneTodosLosPokemones { + grid-template-columns: repeat(3, 1fr); + grid-gap: 71px; + margin: 6%; + margin-top: 2%; +} +} + /* + ##Device = La mayoría de los Smartphones Móviles (Portrait/Vertical) + ##Screen = B/w 481px to 768px +*/ +@media (max-width: 768px) { + /* Vista 1 */ + #contieneTodosLosPokemones { + display: grid; + grid-template-columns: repeat(2, 1fr); + grid-gap: 50px; + margin: 3%; + } + #empezar { + border: 1px solid black; + border-radius: 7px; + padding: 1px 1em; + background: #0573C0; + color: rgb(249, 248, 248); + font-family: monospace; + font-size: 80%; + font-weight: 600; + text-decoration: none; + width: 30%; + text-align: center; + height: 50px; + margin-bottom: 17%; +} +} + /* + ##Device = La mayoría de los Smartphones Móviles (Portrait/Vertical) + ##Screen = B/w 320px to 479px +*/ + @media (max-width: 480px) { + /* Primera Vista */ + #logoVista1 { + width: 100%; + height: 197px; +} + #letra { + text-align: center; + font-family: Alkatra; + font-size: 78%; + font-weight: 500; + margin-bottom: 20%; + } + #empezar { + border: 1px solid black; + border-radius: 8px; + padding: 1px 1em; + background: #0573C0; + color: rgb(249, 248, 248); + font-family: monospace; + font-size: 60%; + font-weight: 600; + text-decoration: none; + width: 25%; + text-align: center; + height: 50px; + margin-bottom: 9%; +} + #imagenGif{ + width: 100%; + position: relative; + top: 130px; + } + #gifPokebolas { + display: flex; + width: 100%; + justify-content: space-around; +} +#contenedorFooter { + background-image: url(img/noche-estrellada.gif); + background-position: center; + text-align: center; + color: white; + font-size: 10px; + font-family: monospace; + font-weight: 700; + padding: 14px; +} + /* Segunda Vista */ +#imgNavBar { + width: 100%; + height: 197px; +} +.botones { + border: 1px solid black; + border-radius: 8px; + padding: 1px 1em; + background-color: #0573C0; + color: rgb(249, 248, 248); + font-family: monospace; + font-size: 130%; + font-weight: 600; + text-decoration: none; + display: inline-block; + width: 35%; + text-align: center; + height: 30px; + margin-top: 2%; +} +.label { + font-size: 100%; + font-weight: 700; +} +.buscador { + width: 50%; + opacity: 4; + text-align: center; + font-size: 110%; + height: 30px; + margin-top: 8px; + margin-bottom: 7px; + justify-content: center; + align-content: center; + gap: 30px; + border: 1px solid black; + border-radius: 7px; +} +#buscar { + background-color: rgb(220, 218, 218); + width: 20%; + height: 23px; + border-radius: 7px; + font-size: 150%; +} +#contieneTodosLosPokemones { + grid-template-columns: repeat(1, 1fr); + grid-gap: 10px; + margin: 20%; + width: 264px; + margin-top: 2%; +} +.Cards { + background: radial-gradient(circle at 50% 0%, orange 36%, #ffffff 36%); + width: 90%; + padding: 23px 20px; + box-shadow: 0 20px 30px rgba(0, 0, 0, 0.15); + border-radius: 10px; + border: 1px solid black; + display: flex; + flex-direction: column; + align-items: center; +} +#imagenGif{ + width: 100%; + position: relative; + top: 5px; +} +} diff --git a/test/data.spec.js b/test/data.spec.js index 09b1f23..85d484b 100644 --- a/test/data.spec.js +++ b/test/data.spec.js @@ -1,23 +1,72 @@ -import { example, anotherExample } from '../src/data.js'; - - -describe('example', () => { - it('is a function', () => { - expect(typeof example).toBe('function'); +import { sortData, filtrar, filtrar1 } from "../src/data.js"; +describe("sortData", () => { + it("Deberia ser una funcion", () => { + expect(typeof sortData).toBe("function"); }); - - it('returns `example`', () => { - expect(example()).toBe('example'); + it("Deberia retorna el array ordenado de A-Z", () => { + const ordenadoAZ = [ + { name: "bulbasaur" }, + { name: "bulbasaur" }, + { name: "ivysaur" }, + { name: "venusaur" }, + { name: "charmander" }, + ]; + const Result = [ + { name: "bulbasaur" }, + { name: "bulbasaur" }, + { name: "charmander" }, + { name: "ivysaur" }, + { name: "venusaur" }, + ]; + expect(sortData(ordenadoAZ)).toStrictEqual(Result); }); }); - -describe('anotherExample', () => { - it('is a function', () => { - expect(typeof anotherExample).toBe('function'); +describe("sortData", () => { + it("Deberia ser una funcion", () => { + expect(typeof sortData).toBe("function"); }); + // it("Deberia retorna el array ordenado de Z-A", () => { + // const ordenadoZA = [ + // { name: "bulbasaur" }, + // { name: "ivysaur" }, + // { name: "venusaur" }, + // { name: "charmander" }, + // ]; + // const Result = [ + // { name: "venusaur" }, + // { name: "ivysaur" }, + // { name: "charmander" }, + // { name: "bulbasaur" }, + // ]; + // expect(sortData(ordenadoZA)).toBe(Result, "name"); + // }); +}); - it('returns `anotherExample`', () => { - expect(anotherExample()).toBe('OMG'); +describe("filtrar", () => { + it("Deberia ser una funcion", () => { + expect(typeof filtrar).toBe("function"); + }); + it("Deberia retorna el array filtrado por tipo", () => { + const tiposdePokemones = [ + { type: "grass" }, + { type: "fire" }, + { type: "ice" }, + { type: "normal" }, + ] + const Result2 = [{type: "grass"}]; + expect(filtrar(tiposdePokemones, "grass")).toEqual(Result2); + }); +}); +describe("filtrar1", () => { + it("Deberia ser una funcion que busque por nombre de pokemon", () => { + expect(typeof filtrar1).toBe("function"); + }) + it('Deberia retornar el pokemon buscado por el usuario', () => { + const pokemonPorNombre = [ + {name: "bulbasaur"} + ] + expect(filtrar1( pokemonPorNombre, "bulbasaur")).toEqual(pokemonPorNombre); }); }); + \ No newline at end of file