CodeProject: Easy To Use “Drop Down Calendar for the Web”…


Drop Down Calendar for the Web
Click title for source at CodeProject.com…

Introduction
Need a quick, easy to use, self setting date selector for use on web pages. Here is a drop down calendar that fills the bill! You can see my demo page here: Calendar Demo.



Background
I have looked around for a date selector to use on web pages for a long time. A couple of years ago I found datetimepicker.js. A popup window date time selector written by TengYong Ng in 2003 (Website: http://www.rainforestnet.com). I used it in several web applications, however, the problem with popup windows is that they can get lost. If the user clicks somewhere else it can end up behind other windows and will not re-appear when the link is clicked again. While making my way through some ajax tutorials, I wondered if I could take the datetimepickers javascript built html code and stuff it into the innerHTML of a page element. So I stripped out all the window stuff and remove the time entry pieces. Added code for auto creation and deletions of a div element and modified how months and years are navigated. This drop down calendar is the result.

After getting a message that FireFox was not a happy browser with this script, I began my search for what will make it happy. Well, after 12 hours of googles, testing, reading, testing and finally some good old trial and error, it seems to do everything it is suppose to for both FireFox and IE7. It is amazing how messy things get when you are trying to make something work across browsers. I was having flash backs of trying to make dos programs that also ran on unix. For example, in IE the div element is created and appended to the body and you can get a height value from Cal.elem.offsetHeight right away, but in FireFox this value remained zero forever. Not ‘undefined’, zero (0). So I wrapped the main table in the div in another table with an id=’calT1′. When the div is appended to the body, FireFox does report document.getElementById(‘calT1′).offsetHeight with the correct height. 97% of my day is writing VC++ code for data recording and reporting in a MS OS environments. One day I said to a customer ‘Oh, I can put all these reports out on the web for you. Then you can access them from anywhere in the world!’. Now I know why most web apps say IEx or Netscape Vxx required. You could spend your career keeping up with browsers and scripts.

Using the code
As with any external script file, we have to get it included in our page. This goes in the head section like this:

<head>// .... other head stuff ...

<script type="text/javascript" src="DropCalendar.js"></script></head>

To make it work all you need is a text box with a name* or id assigned and a hyperlink to call the javascript. Here I’m using an image as the hyperlink to open the calendar. (*FireFox and the like really wants an id not a name)

<body><input type="text" id="T2" size="14"><a href="javascript:OpenCal('T2');">

<img border="0" src="cal.gif" width="16" height="16"></a></body>

That’s all there is to it. You can change some of the characteristics of the calendar by modifying the global variables found in the script file. Things that can be changed are colors, size of the drop down, font size and default format. You can also change the format of the date display by sending it as a second argument. The default is mmddyyyy. Don’t include any separators like slashes ‘/’ in the format.

Points of Interest
The calendar will always show up attached to the bottom left corner of the text box, unless it would be off the page. It will be slid to the left if it would have gone off the right side and it will be attached to the top of the text box if it would have gone off the bottom of the browser.

Navigation of months and years is via the << < and > >> hyperlinks on the calendar.

The user can close the calendar by clicking the X in the top right corner or by clicking the hyperlink image that originally opened it.

The calendar drop down box is like Highlander, There can be only one. If you click a second link on a page that has multiple calendar links on it, the calendar closes it’s original position and moves to the new one.

The script basically creates the body of a html page made up of tables of hyperlinks that calls functions to navigate dates or select them and puts the selection in the text box via it’s value member. When you call OpenCal it creates a div element on your page and stuffs the html calendar into it’s innerHTML member and appends it to the document.body collection.

When the calendar is closed, the div element is removed from the document.body via the removeElement method. The close function then deletes the calendar which destroys the div element along with it.


About this entry