YUI Library Home

YUI Library Examples: Browser History Manager: Calendar Control

Browser History Manager: Calendar Control

This example demonstrates how to use the Browser History Manager to remember which months have been viewed with the calendar widget and dynamically update it when the user presses the browser's back/forward buttons.

Basic markup

In our example, the calendar widget relies on the following markup:

Add the markup required by the Browser History Manager

This markup should be inserted right after the opening body tag.

Import the source files and dependencies

In our example, we need the Event Utility, DOM Utility, Calendar Widget, and the Browser History Manager:

Design your application

In our simple example, we have only one module, represented by the calendar widget. We will refer to this module using the identifier "calendar". The state of the calendar module will be represented by a string composed of the month and the year the widget currently renders, separated by "_" (e.g. "2_2007" for February 2007)

Retrieve the initial state of the calendar module

Use the YAHOO.util.History.getBookmarkedState method and default to the month corresponding to today's date:

Register the calendar module

Use the YAHOO.util.History.register method, passing in the calendar module identifier, the initial state of the calendar module, and the callback function that will be called when the state of the calendar module has changed:

Write the code that initializes your application

Use the Browser History Manager onReady method

Use the Browser History Manager onReady method to instantiate the calendar widget. Also, retrieve the current state of the calendar module, and use that state to show the right month (the current state may be different from the initial state under certain circumstances - see the User's Guide)

Add history entries

A new history entry must be added every time the user views a new month. Use the calendar widget's beforeRender event handler (set to handleCalendarBeforeRender - see above):

Initialize the Browser History Manager

Simply call YAHOO.util.History.initialize, passing in the id of the input field and IFrame we inserted in our static markup:

Configuration for This Example

You can load the necessary JavaScript and CSS for this example from Yahoo's servers. Click here to load the YUI Dependency Configurator with all of this example's dependencies preconfigured.

Copyright © 2009 Yahoo! Inc. All rights reserved.

Privacy Policy - Terms of Service - Copyright Policy - Job Openings