YUI recommends YUI3.
YUI 2 has been deprecated since 2011. This site acts as an archive for files and documentation.
This documentation is no longer maintained.
Clicking in the blue box will pop up a "Hello World!" alert window. Clicking on the first link will take you to the YUI website; clicking on the second link, which has the same
href attribute, will pop up an alert instead and not navigate to a new page.
Event Utility is used here to do two things:
clickevent handler to the blue box;
<a>element that uses
YAHOO.util.Event.preventDefault()to prevent the link, when clicked, from navigating to a new page.
The YUI Event Utility is a simple, powerful resource for creating event-driven applications in the browser. In this very simple example, we'll look at how to use Event Utility to listen for a specific event on a specific element. We'll also look at how Event Utility can be used within an event handler to provide additional control.
To illustrate event handling syntax, we'll create a
<div> and pop up an alert message when that
<div> is clicked on. Begin with the style and markup necessary to make your element visible:
Next, create a function that receives a single argument — the event object — and pops up an alert which says "Hello World!":
With our markup on the page and a function that we want to execute when our element is clicked on, we now use Event Utility's
addListener method to attach our
helloWorld function as a handler for the click event on the element whose HTML ID is "container":
Almost all event handling begins with a premise just this simple: We have an element ("container") to which something might happen (eg, it might be clicked) and, when that does happen, we want to do something (eg,
In some cases, you may want to use some of Event Utility's powerful browser abstraction methods to help you handle your interaction flow during an event. For example, lets say you have two links on the page:
Imagine that when the second link is clicked you want to pop up an alert window and then prevent the browser from navigating to the page designated in the href attribute. The event object has a
preventDefault mechanism, but that mechanism was not successfully implemented across all A-Grade browsers until quite recently. So, instead of using the built-in version of
preventDefault, we can use Event Utility's method which features normalized support for a greater number of browsers:
In line 5 above, we take the event object, passed into us by the Event Utility when the handler is called, and we apply the Event Utility's
preventDefault method to it. We can use a similar pattern for all of Event Utility's helper methods (
Note: Logging and debugging is currently turned off for this example.
All YUI 2.x users should review the YUI 2.8.2 security bulletin, which discusses a vulnerability present in YUI 2.4.0-2.8.1.
Copyright © 2013 Yahoo! Inc. All rights reserved.