New terms from treehouse – jQuery Basics Part 1 – Basics and Spoilers/Lightbox Projects

jQuery is like CSS in that it takes the JS out of the markup and let’s you modify it in another place. It also uses the same selectors as CSS.

Unobtrusive (as in, not getting in the way of the user) JS is all about putting the user first, and making sure the site works regardless of their connection, browser or device. This is the key to user experience.

What is jQuery? A javascript library, which is just a collection of JS code. You write in in a separate .js file. You can use jQuery as a function, which if you remember needs to be followed by parentheses. Simply write in the CSS selector of the element you want to manipulate. In this case we want to hide the “It’s a trap” text then make it appear. Since we want to select a class, we write it with a period first like we would in CSS, then surround it in quotes.

Screen Shot 2014-09-24 at 5.26.16 PM

Screen Shot 2014-09-24 at 5.31.50 PM

You can then call methods on them to modify their behavior. In this case we want to hide it, but where would we look to learn how to do that? You can check out the documentation site.  Use the search box in the top right to look for stuff. Here we want to use .hide(). Notice how it gives code examples at the bottom.

Screen Shot 2014-09-24 at 5.36.43 PM

To get it to show, we’ll use the .show() method. However, if we just add that it won’t give us what we want, the “It’s a trap” will show instantly. So, we pass in the string “slow” as a parameter, like we saw in the documentation.

Screen Shot 2014-09-24 at 5.44.27 PM

Now, instead of having to write jQuery all the time, you can instead use a $.

Screen Shot 2014-09-24 at 5.45.33 PM

jQuery has method chaining, which allows you to reduce redundancy in your code. You can add methods after each other to affect the same selected elements. This works because many jQuery methods return the element they were selecting. So, hide() returns the .warning elements.

Screen Shot 2014-09-24 at 5.48.46 PM


DOM

The Document Object Model is how the browser interprets the html files. Aka the DOM tree.

Screen Shot 2014-09-24 at 5.51.58 PM

HTML elements can be manipulated, added and removed using JS. In dev tools, you can pull the document object, which everything hangs off of. Screen Shot 2014-09-24 at 5.55.21 PM

Let’s say we wanted all the children elements of the head element. Simply write document.head.children

Screen Shot 2014-09-24 at 5.57.25 PMYou can access this array of elements just like any array, by passing in the index of the element you want. If we want the first p element in the body, we’d write document.body.children[0]. Remember, you can pull up what you’ve previously written by using the up key.

Screen Shot 2014-09-24 at 6.00.17 PM

However, this it a brittle way to program, we don’t know if the order of the elements in the html document will change in the future.

Moving from on element to another is called traversal, or, traversing the DOM.

The method getElementByClassName is a much better option. Here we’ll select the element with the .warning class: document.getElementsByClassName(“warning”). Note that in the string a period wasn’t used, because we’re already saying we want a class name with the method.

Screen Shot 2014-09-24 at 6.05.07 PM

jQuery makes this way easier, and also will make it work with all browsers.

Screen Shot 2014-09-24 at 6.07.19 PM


jQuery Documentation

There are different kinds of methods based on what you’re looking to do.

Screen Shot 2014-09-24 at 6.44.42 PMScreen Shot 2014-09-24 at 6.45.21 PMScreen Shot 2014-09-24 at 6.45.50 PM

Now, we’ll go over the different categories listed on the left hand side in the documentation.

The attributes category lets you change and modify the attributes of elements, like if you need to change the href attribute for a link. You can also use this to add/remove classes, or see if an element has a class.

The CSS category lets you change and read the style properties. You’ll find that the add/remove class methods are here as well, sometimes they will be in multiple categories.

The dimensions category lets you check an elements heights, widths, etc, with or without the padding and margins. This is manipulation.

The effects category is manipulation over time, like an animation, showing, hiding, fading in/out, etc.

The events category is basically for when a user interacts with a thing, like the keyboard in a form, scrolling, resizing a window, etc, then doing something when that occurs. Has sub categories for each of these. Can be triggered by user or the computer.

The offset category is similar to dimensions, is used to figure out the offset of an element, like from the top or the left of a parent element, how far it’s been scrolled right of left. Handy for triggering an event for the browser to scroll to the top or bottom of a page.

The traversing category includes all the methods to move around the document and manipulate it. Like getting the children of an element, or elements with a certain class.

The selectors category talks about the CSS selectors that can be used for jQuery. There are even special jQuery selectors can only be used with it and not CSS.


Ways to include jQuery in a project

You can download it from jQuery.com. But, what most people do is host it on a CDN, a Content Delivery Network, which serve jQuery all over the world. The nice thing is if the user has already been on a page that has this, it’s been cached in their browser so they don’t have to download it again. Put the CDN link above your link to your .js file.

Screen Shot 2014-09-24 at 7.08.10 PM

However, when we try to execute the function in our .js file, it doesn’t work.

Screen Shot 2014-09-24 at 7.10.28 PM

In the documentation, under Events > Document loading, we find the ready() method, used for executing a function when the DOM is fully loaded. Note the other two hear are marked as depreciated and should be ignored. Looks like there’s three ways to do this.

Screen Shot 2014-09-24 at 7.14.05 PM

We can select the document itself and run it with this method, we’ll ignore the second method, or simply run the function when the page is ready.

It’s worth noting, that “handler” is explained above, and basically just means the function you want to run.

Screen Shot 2014-09-24 at 7.14.11 PM

We’ll try the first method. Note that we don’t use parentheses to call the function in this case, as we want jQuery to do that once the page is loaded.

Screen Shot 2014-09-24 at 7.17.44 PM

Now, remember that we can also declare functions using a variable. So instead of this,

Screen Shot 2014-09-24 at 7.18.44 PM

we do this, and it still will work.

Screen Shot 2014-09-24 at 7.19.31 PM

Now, a lot of times people will use functions without a name, aka an anonymous function. We can actually pass the function itself into the ready method. The example below works as well.

Screen Shot 2014-09-24 at 7.21.58 PM

If you remember, the third way that you can do this is by simply passing the handler into the jQuery method, which is $().

Screen Shot 2014-09-24 at 7.23.35 PM

Now, in our original example last lesson we didn’t do that, because we included our jQuery at the bottom of the mark up.

Screen Shot 2014-09-24 at 7.25.02 PM

By doing this, the code will still work, but now we don’t need to wait for that .ready event to be triggered by the DOM. Because we’re including the JS at the bottom of the page, we can assume that the DOM has already loaded. We can now cut out those parts of the code.

Screen Shot 2014-09-24 at 7.27.47 PM

This way of including the JS at the bottom of the page is a best practice, because it speeds up the user’s experience. It’s a bit faster, and lets your content and images load before your JS files do.


Spoiler revealer project

Screen Shot 2014-09-25 at 2.17.30 PM

Preparation is where is sleuth out what the problem is (the first two lines below). In the plan stage, we’ll write some pseudocode, which is high level, informal code that describes what we’re looking to do.

Screen Shot 2014-09-25 at 2.26.23 PM

We’ll start by selecting the span containing the spoiler. Note how we were able to use a descendent selector, just like in CSS.

Screen Shot 2014-09-25 at 2.35.08 PMScreen Shot 2014-09-25 at 2.35.14 PM

Next, we need to add a button. To do that we’ll use append(), listed under Manipulation, which adds content to the end of the specified element. The parameters is accepts include html, so we’ll make it take a button. NOTE: They already had styling in place for the button.

Screen Shot 2014-09-25 at 2.41.31 PM

Screen Shot 2014-09-25 at 2.41.49 PM

Now, we want to hide the button and show the spoiler on a mouse click. Under Event > Mouse Events we find the .click() method. To remove the button, we’ll use the .remove() method under the manipulation > DOM removal section.

Screen Shot 2014-09-25 at 3.05.57 PM

Now, will the remove method we were able to use “this”, rather than having to write the selector for button elements. The nice part about this is that it refers to specific button that’s being clicked, and will affect just that button, rather than all buttons on the page. If we were to instead use the button selector, all buttons on the page would be removed whenever we clicked any button.

REMEMBER, the selector you put in the parentheses after the $ is what is going to be affected by the method after. So $(“.spoiler span”).show(); will show any span element within one with the spoiler class.

Now, to perfect our project. Let’s put in another spoiler. Issue – when we click one of the buttons, both spoilers get revealed.

Screen Shot 2014-09-25 at 3.10.14 PM

In our current code, we’re selecting all spans within a spoiler class element, which is not good, we only want to affect the span for the button we clicked. We want to select the previous element to the button, which we can do with the prev() method, under the traversing the DOM section. It selects the immediately preceding sibling element.

Screen Shot 2014-09-25 at 3.15.21 PM Screen Shot 2014-09-25 at 3.15.17 PM

Now, jQuery methods return things, which I guess means the things that will be selected. So with $(“.spoiler span”).hide();, it’s returning what was selected in those first parentheses. However, with something like the  $(this).prev().show(); used above, .prev() is actually returning the sibling of button (which were using this to refer to), rather than button itself. That sibling is then affected by the .show() method.


Creating a Simple Lightbox

Issue is that when you click on one of the images it takes you to a dead end, which is a poor UX. Solution: make a lightbox with jQuery. Here’s that with the psuedocode for our plan:

Screen Shot 2014-09-26 at 2.34.13 PM

First, we need to capture the click. The best way to do this, with keeping future scenarios in mind, would be to create an id for the unordered list. That way, if there are non image links added to the site later they won’t be affected. To do so, we then simply write $(“#imageGallery a”).click();

To add to that, we want to select the info in the href attribute for those links. We can use this to make sure we’re getting it from the link that’s just been clicked, along with the attr() method, which is unsurprisingly listed under the attribute section. We can simply pass in a string for the name of the attribute we want. We can then store that in a variable, which we’ll name href, then use a console.log with that variable to display it in the console. We should now see what was listed as the value for its href attribute.

Screen Shot 2014-09-26 at 2.50.33 PM

The issue though is that if we click a link it still takes us to another page with just the image, we need to stop that. The event.preventDefault() method will do just that. If it is called, the default action of the event will not be triggered. So if it’s a link, it won’t take you to a page with that URL.

Screen Shot 2014-09-26 at 2.54.52 PM Screen Shot 2014-09-26 at 2.54.20 PM

Good progress. Though 1.1 is to show the overlay, we actually need to add the overlay to the document first. You do NOT want to add this to the HTML, but rather via the jQuery. This is because you don’t want to add any markup that’s unnecessary. If someone didn’t have JS turned on in their browser and you added the overlay in the html, they would then see that with everything else and it would be weird.

We’ll move this step to the top, remember, pseudocode order can be rearranged.

Screen Shot 2014-09-26 at 3.04.09 PM

Now, we want to use and do things (update the image/caption, hide and show it) to the overlay, so it’s best if we store it into a variable.

Screen Shot 2014-09-26 at 3.06.13 PM

But, this won’t do us much good, as it’s just storing that as a string, and we need it to be a jQuery representation of an object. jQuery lets you create a representation of a DOM element that isn’t part of the document yet, yet still use it in your code. This is called a disembodied element. Select the string and put $() around it. Also, it’s good to add a $ to the variable name, so you know it’s a jQuery representation of an object, and not a string or something. This is a common practice.

Screen Shot 2014-09-26 at 3.11.48 PM

This adds the div to the page, which we can then style.

Screen Shot 2014-09-26 at 3.16.44 PMScreen Shot 2014-09-26 at 3.16.53 PM

Since we want to hide it by default, rather than doing the .hide() method with jQuery, we’ll just do display: none; in the CSS. We’ll also add opacity, so it looks like all lightboxes for when we do eventually display it.

Screen Shot 2014-09-26 at 3.19.02 PM

Finally, because we made the div a jQuery object instead of just a string, we can use the show method on it directly, rather than having to do $(“#overlay”).

Screen Shot 2014-09-26 at 4.26.47 PM

Now we need the overlay to show the image that was clicked. We’l start by creating another jquery object that is an img tag. Then, even though the $overlay object hasn’t been appended to the body yet, we can still mess around with it and append the $image object to it. Now when it does get appended to the body, it will include and <img> tag.

Screen Shot 2014-09-26 at 4.29.38 PM

Now, we need the image in the overlay to update and show the correct image. We can use the attr() method again, this time to modify the src attribute for it.

Screen Shot 2014-09-29 at 12.40.30 PM

Now href as a variable name could get confusing later, so we’ll rename that variable to imageLocation. WE’ll also remove that console.log, since we don’t really need it anymore.

Screen Shot 2014-09-29 at 12.46.40 PM

Aside – I original made the overlay background: black; with opacity: .7;, but this actually made the image transparent as well. But, by doing rgba(0,0,0,.7);, it only made the overlay transparent and not the image.

We’ll now do some quick styling for the image, giving it a margin top of 10%, and giving its parent overlay a text-align:center so it is centered.

Screen Shot 2014-09-29 at 12.51.56 PMScreen Shot 2014-09-29 at 12.52.01 PM

Now, we want the overlay to go away when clicked again. We’ll start with the jQuery $overlay object and the click method, with an anonymous function. Within that, we can use $(this) or even the $overlay object with the hide() method.

Screen Shot 2014-09-29 at 12.59.06 PM

Time to add the caption. We’ll start by adding another disembodied element at the top, then appending that to our overlay, like we did for the $image earlier.

Screen Shot 2014-09-29 at 1.03.13 PM

So if you recall, the click event handler is tied to the link, but the links child img element has the alt attribute we need for the caption.

Screen Shot 2014-09-29 at 1.05.02 PM

We’ll look under the traversing the DOM section of the documentation for this, and see that the children() method is what we need here. We’ll start by using $(this), which selects the link we’ve clicked on, followed by children(“img”), which selects that link’s child img elements, follow by attr(“alt”), which gets that img’s alt attribute’s value. Finally, we’ll set all that equal to the variable captionText so we can use it later.

Screen Shot 2014-09-29 at 1.13.17 PM

Now we need to manipulate the $caption object to add the content of the captionText variable in there, so we’ll look under Manipulation this time, and find the text() method. NOTE: a lot of jQuery methods are setters ad getters. Usually, if you don’t pass in a parameter it will get you info from the selected element, and if you do, it will set info for that element.

So, we simply do  $caption.text(captionText);

Screen Shot 2014-09-29 at 1.21.17 PM

Slight issue, p text was black so you couldn’t see it unless you highlighted it, so we restyled it white.

Screen Shot 2014-09-29 at 1.22.34 PM

And on to the next one. Feels good to be back on track.

Advertisements

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Google+ photo

You are commenting using your Google+ account. Log Out / Change )

Connecting to %s