DOM EVENTS

LESSON OBJECTIVES#

after this lesson, students will be able to:

Describe what a browser event is
Create a click event
Use a named, referenced function as the click handler for the listener

Describe what a browser event is#

Every kind of interactivity in the browser is an event: clicks, mouseovers, key presses, scrolling, resizing, loading the page, and more.

When you interact with the browser it checks to see if there is a listener for that interaction.

If there is a listener present, the browser will try to run any handlers for those interactions.

A handler is just a function that runs a desired procedure.

Create a click event#

How can we set up a click event?

We need:

An element to set it on
A listener that listens for the event: on which element should the event take place
A handler that runs the procedure we want to have happen when the event is triggered

Make a button in the html:

<button id="btn">Click me<button>

Grab the button in the JS (DOM element):

$(()=>{  const $btn = $('#btn');  console.log($btn);})

Event listener#

Set an event listener:

Use .on() .on() documentation

$btn.on('click');

The event listener takes a string as an argument. There are just a few strings that it will recognize as valid events, and 'click' is one of them.

List of events

Event handler#

Add a function that runs what we want to have happen. This function is what handles the event and is called an event handler:

$btn.on("click", () => {  console.log("button was clicked!!");});

Notice that we have supplied a function as an argument. The jargon for using a function as an argument to another function is callback.

pseudo code for an event listener

elem.on(STRING, CALLBACK);

Add Text to the Page on Click#

$btn.on("click", () => {  $("body").append("It seems as if it has been clicked!");});

Use a named, referenced function as the click handler for the listener#

The handler that we used for our click was anonymous. It was a function that had no name. We just told the listener to run an anonymous function. We can give our function a name and thereby reuse that function with other event listeners.

Named Function#

We can abstract the anonymous function out and give it a name:

Separate function, not inside the listener:

const addText = () => {  $("body").append("It seems as if it has been clicked!");};

We can then reference it in the event Listener:

$btn.on("click", addText);

With a named function, we can use the same handler for more than one DOM element.

Referenced Function#

Note that we do not invoke the function with parentheses. We do not want to invoke the function right away, we merely want to reference it to be invoked when the listener runs it.

The function should be defined before it is used in the event listener
When the function is invoked inside the event listener leave out the parentheses. We do not want to invoke the function right away! We merely want to reference that function in the listener.

Here the function is invoked and will run immediately:

$btn.on("click", addText());

We don't want this! We only want the function to run when the user has clicked on the 🔲 button.

Complete code:

const $btn = $("#btn");
const addText = () => {  $("body").append("It seems as if it has been clicked!");};
$btn.on("click", addText);

Let's do something fancier, and toggle the background-color of the page using .toggleClass()

const changeClass = () => {  $("body").toggleClass("black");};
$("#btn").on("click", changeClass);

CSS:

.black {  background-color: black;}