/spa-group-project-ahmedful

spa-group-project-ahmedful created by Classroom for GitHub

Primary LanguageJavaScript

Chatty Group Project

Setup

Every teammate copy and run the following commands in the host machine terminal.

mkdir -p ~/workspace/group-projects && cd $_
git clone [Github Classroom repo URL]
cd [repo name]

Requirements

Check out the simple wireframe for this application on Moqups.com. You can make your final interface as fancy as you like, but keep the general layout similar to the wireframe.

Navigation bar

  1. Create an element to serve as the navigation bar for your application.
  2. Create an element to hold the logo for your application. It can be as simple as text, but if you want to find an image, that's fine.
  3. Create a input field for a user to enter in a message.
  4. Add an event listener for "keypress" and detect when then return key has been pressed in the message field.
  5. When return key is detected, you'll create a new message (see details below).
  6. Create a button to clear all messages.
  7. When the user clicks the clear messages button, all current chat messages should be removed from the application.
  8. If there are no messages, then the clear messages button should be disabled (see example above).
  9. The navigation bar should remain at the top of the screen, even if the contents of the page start to scroll.

Options

  1. Create two checkboxes below the message input field. One labeled "Dark theme" and the other labeled "Large text".
  2. When the user clicks on the dark theme checkbox, change the background color of your application to a dark gray, and the font color for messages should be white(ish)... you pick.
  3. If the user unchecks the box, the background color should change back to white with black text for messages.

Messages

  1. When the user presses the return key in the message field, create a <div> element in the DOM, below the input field that will hold all messages as they get created.
  2. The message should have a button displayed after it with the text "Delete" inside of it.
  3. When the delete button next to a message is clicked, only that message should be removed from the DOM.
  4. When the page is first loaded, you must load 5 messages from a local JSON file and pre-fill the message area with those messages.

Modular Code

Create multiple IIFEs, following the Single Responsibility Principle, that perform the following functions. The name of your global variable that gets augmented by the IIFEs should be Chatty.

  1. One IIFE should load the JSON file and returns the array of objects.
  2. One IIFE should accept an element id, and the user message, and then add the user's message - along with the delete button - to the specified parent element. Each message should be stored in a private array in this IIFE. This IIFE should expose a function to read all messages, and delete a single message.
  3. One IIFE should accept a message element id and then remove the correct element from the DOM. This IIFE should also remove the corresponding message from the private array that was created in the previous IIFE.

Helpful hints

Adding listeners to dynamically created elements

When you add a DOM element to your page with JavaScript, you cannot add a listener to them directly in your code with addEventListener. This is because the element didn't exist when your JavaScript file got parsed and executed by the browser when it loaded. What you need to do is listen for the event on the <body> element, and then inspect what the target of the event is (i.e. which element the user actually performed the action on).

document.querySelector("body").addEventListener("click", function(event) {
  console.log(event);

  // Handle the click event on any li
  if (event.target.tagName.toLowerCase() === "li") {
    console.log("You clicked on an <li> element");
  }

  // Handle the click event on any DOM element with a certain class
  if (event.target.className === "article-section") {
    console.log("You clicked on an `article-section` element");
  }

  // Inspect the `id` property of the event target
  if (event.target.id === "page-title") {
    console.log("You clicked on the page-title element");
  }
});

Setting element attributes

You can use JavaScript to set any attribute on a DOM element. You've seen how to add/remove classes with classList.add(), classList.remove(), and classList.toggle(), but you can also add id, href, src, or any other attribute.

Here's an example of how to add a disabled attribute to a button in the DOM.

<button class="clear-messages">Clear messages</button>
// This will disable the first button with a class of "button-message"
document.getElementsByClassName("button-message")[0].setAttribute("disabled", true);

Bonus criteria

For you overachievers, once you've completed the basic criteria, take a stab at these.

Multiple JSON files

Instead of having one JSON file with five messages in it, break each message into its own JSON file. How do you handle loading them in succession?

Editing

  1. Let users edit an existing message. Add an edit button next to the delete button that, when clicked, will take the message and put it back in the message input at the top.
  2. Once user edits the message and presses the return key again, the message text in the list should be updated.

Custom themes

  1. Add a button/link to the UI labeled "Change Theme".
  2. Remove the existing elements for changing the theme.
  3. When user click on Change Theme element, show a Bootstrap modal dialog box.
  4. Inside the modal, show two color picker fields - one for background color and one for font color.
  5. Add a Save and Cancel button to modal.
  6. When user clicks Save apply the chosen colors.

Multiple users

  1. Create an object in your JavaScript that holds an array of names (see example below).
  2. Next to the message input box, there should be a radio button group for each name in the list.
  3. When a user enters a message, it should be prepended with the chosen user's name, in bold text.
  4. Keep in mind that this will likely change the structure of your JSON file since the pre-loaded messages have to have this information on them.
// User object
var users = {
  names: ["Xavier", "Joanna", "Mackenzie", "Gunter", "Iveta", "Sven"];
};

Message limit

  1. Only show the last 20 messages.

Timestamp

  1. Put a timestamp on each message.
  2. Again, this will change the structure of your JSON file.