Setting up the Calendar

For this tutorial, it is assumed that you are starting with the basic Calendar outlined in the Quickstart example. The setup for the basic Calendar looks like this:

YAHOO.example.calendar.cal1 = new YAHOO.widget.Calendar("cal1","cal1Container"); YAHOO.example.calendar.cal1.render();

Enabling the minimum and maximum date features is as easy as adding additional arguments to the constructor's configuration object. In this tutorial, we will be working with three different configuration properties: pagedate, mindate and maxdate. In brief, here is a description of these properties and what they do:

• pagedate - Specifies the month/year of the Calendar's initial view. For example, setting a value of "1/2009" would set the Calendar to January 2009.
• mindate - Specifies the minimum selectable date for the Calendar. All dates before the minimum date will be grayed out. The value can be specified as a JavaScript Date object or as a string (e.g. "1/5/2009").
• maxdate - Specifies the maximum selectable date for the Calendar. All dates after the maximum date will be grayed out. The value can be specified as a JavaScript Date object or as a string (e.g. "1/15/2009").

Of course, you can specify these properties independently for different results. For instance, if you only wanted users to be able to select days following August 2, 2009, you would set the mindate property to "8/2/2009" and no dates prior would be selectable.

For this example, we will set the current month view to January 2009 using the pagedate property, and we will limit the Calendar's minimum selectable date to January 5, and the maximum selectable date to January 15.

YAHOO.example.calendar.cal1 = new YAHOO.widget.Calendar("cal1","cal1Container", { pagedate: "1/2009", mindate: "1/5/2009", maxdate: "1/15/2009" } ); YAHOO.example.calendar.cal1.render();

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.