/lab-03

Primary LanguageJavaScript

Lab 03: Flexbox and Templating

Configuration

Your repository must include the following config files:

  • README.md - with an overview of the project for a new visitor to your repo

  • .gitignore - with standard NodeJS configurations (see the provided .gitignore file)

  • .eslintrc.json - with Code 301 course standards for the linter (see the provided .eslintrc.json file)

  • Organize your files into folders as you see fit. Here is an example file tree:

lab-03-repository
├── .eslintrc.json
├── .gitignore
├── css
│   ├── base.css
│   ├── layouts.css
│   ├── modules.css
│   └── reset.css
├── data
│   ├── page-1.json
│   └── page-2.json
├── index.html
├── js
│    └── app.js
└── README.md

Resources

Deployment

Deploy your photo gallery on GitHub pages, as you have done in Code 201. As a reminder, in your repository, click on Settings and scroll down to the GitHub Pages section. Select your master branch and verify that your photo gallery appears the way you expect it to look on the deployed site.

Complete this step before moving on to today's features.

User Acceptance Tests

Overview

Today you and your partner(s) will add pagination to your image gallery.

You will also be refactoring your photo gallery in two ways: you will use Handlebars for templating and you will use Flexbox for styling.

You will also be adding the ability for the user to sort the images, if you did not complete the stretch goal from lab 2.

Time Estimate

For each of the features listed below, make an estimate of the time it will take you to complete the feature, and record your start and finish times for that feature:

Number and name of feature: ________________________________

Estimate of time needed to complete: _____

Start time: _____

Finish time: _____

Actual time needed to complete: _____

Add this information to your README.

Feature 1: Pagination

Why are we implementing this feature?

  • As a user, I want to have the ability to view additional images so that my view does not become cluttered.

What are we going to implement?

Given that a user opens the application in the browser
When the user clicks on a button or link to another page
Then the other set of images should be dynamically displayed

How are we implementing it?

  • Add navigation for the user to switch between two pages. Each page should render a unique set of images from one of the two provided JSON files.
  • Reset the filters, then repopulate them using only keywords from the images currently being displayed.

Feature 2: Templating

Why are we implementing this feature?

  • As a user, I want all of the images to be displayed in a consistent manner, so that it is easy to scan the collection of images.

What are we going to implement?

Given that a user opens the application in the browser
When the images are displayed on the screen
Then each image should be rendered according to a template

How are we implementing it?

  • Create the appropriate Handlebars template in your HTML with the same <h2>, <img>, and <p> elements as the jQuery template from the prior lab.
  • Refactor the method that renders your images to use Handlebars instead of making a copy with jQuery.

Feature 3: Styling with Flexbox

Why are we implementing this feature?

  • As a user, I want a simple, clean looking UI so that my photo gallery clearly displays the images.

What are we going to implement?

Given that a user opens the application in the browser
When the user navigates to the home page
Then the images should be displayed in columns, as screen width allows

How are we implementing it?

  • Refactor your CSS to use Flexbox instead of floats. You are welcome to use a combination of floats and Flexbox, as you see fit.

Feature 4: Sort the images

Why are we implementing this feature?

  • As a user, I want to be able to sort the images so that there is an order to their rendering.

What are we going to implement?

Given that a user is presented with sort options
When the user clicks on one option
Then the images should be sorted accordingly

How are we implementing it?

  • Add the ability for the user to sort the images by either title or by number of horns.
  • Sort the images by one of the properties on page load. This should also apply to the second page of images.

Stretch Goal: Detail view

Why are we implementing this feature?

  • As a user, I want the image to be displayed in a larger size and with the description shown so that I can view the details of a single image.

What are we going to implement?

Given that a user wants to view the details of the image
When the user clicks on an individual image
Then the image should render larger on the screen with the description displayed

How are we implementing it?

  • Add a detail view which will display the image in a larger size in the center of the screen with a colored background.
  • The description should be shown now, as well.
  • When the user clicks off of the image, return to the grid view.
  • Use a transition or animation to show and hide the detail view of an image.

Stretch Goal: Fuzzy search

Why are we implementing this feature?

  • As a user, I want the ability to search my images so that I can view only the images containing specific titles or keywords.

What are we going to implement?

Given that a user enters wants to view specific images
When the user enters a character into the search field
Then only the images matching the current set of characters should be displayed on the screen

How are we implementing it?

  • Create an input element to allow users to search for an image. It is up to you and your partner to decide if the user should be able to search by title, keyword, or both.
  • Write a regular expression pattern to create a fuzzy search so that the results are narrowed down and displayed every time the user enters or removes a character from the input.

Submission Instructions

  • Complete your Feature Tasks for the day
  • Create a Pull Request (PR) back to the master branch of your repository
  • On Canvas, submit a link to your PR and a link to your deployed application on GitHub pages. Add a comment in your Canvas assignment which includes the following:
    • A question within the context of today's lab assignment
    • An observation about the lab assignment, or related 'Ah-hah!' moment
    • How long you spent working on this assignment