Overview
I recently needed to build a web page that would allow a user to capture some information and most importantly select multiple dates. This functionality was core to the application and hence had to be easy and quick to do. This is a public facing website so it had to be intuitive and very responsive.
On the face
of it it didn't seem too hard, I know enough juery to know what it is capable
of and I was pretty sure that there would be some plugins that would help speed things along the way. I'm using ASP.Net MVC for this project as I really like the control that it gives you over the generated html and javascript. After years
of Web Forms development it makes me feel like a web developer again and puts a smile on my face, that can only be a good thing!
The Calendar
The first item that I needed on this page was a calender and I wanted the ability to:
have the calendar be always visible
select/deselect multiple dates at the same
time
bind to the select/deselect event so that I could update a seperate listing
of the selected dates
allow the user to move to another month and still have the calender remember any dates in the previous month
I was hoping that there was a jQuery plugin that would meet my requirements and luckily there was! The jQuery datepicker does everything I want and there is quite a bit
of documentation on how to use it. It makes use
of a javascript date library date.js which I had not come across before but has a number
of very useful date utilities that I have used elsewhere in the project.
As you can see from the image there still needs to be some styling done! But there will be plenty
of time for that later. The calendar clearly shows which dates the user has selected in red and i also make use
of an unordered list to show the the selected dates so the user can always clearly see what has been selected even if they move to another month on the calendar. The javascript code that is responsible for listening to events on the calendar and synchronising the list look as follows:
<script type="text/javascript">
$(function () {
$('.datepicker').datePicker({ inline: true, selectMultiple: true })
.bind(
'dateSelected',
function (e, selectedDate, $td, state) {
var dateInMillisecs = selectedDate.valueOf();
if (state) { //adding a date
var newDate = new Date(selectedDate);
//insert the new item into the correct place in the list
var listitems = $('#dateList').children('li').get();
var liToAdd = "<li id='" + dateInMillisecs + "' >" + newDate.toString('ddd dd MMM yyyy') + "</li>";
var targetIndex = -1;
for (var i = 0; i < listitems.length; i++) {
if (dateInMillisecs <= listitems[i].id) {
targetIndex = i;
break;
}
}
if (targetIndex < 0) {
$('#dateList').append(liToAdd);
}
else {
$($('#dateList').children("li")[targetIndex]).before(liToAdd);
}
}
else {//removing a date
$('ul #' + dateInMillisecs).remove();
}
}
)
});
When a date is selected on the calendar a function is called with a number
of parameters passed to it. The ones I am particularly interested in are selectedDate and state. State tells me whether the user has selected or deselected the date passed in the selectedDate parameter. The <ul> that I am using to show the date has an id
of dateList and this is what I will be adding and removing <li> items from.
To make things a little more logical for the user I decided that the date should be sorted in chronological order, this means that each
time a new date is selected it need to be placed in the correct position in the list. One way to do this would be just to append a new <li> to the list and then sort the whole list. However the approach I took was to get an array
of all the items in the list
var listitems = ('#dateList').children('li').get();
and then check the value
of each item in the array against my new date and as soon as I found the case where the new date was less than the current item remember that position in the list as this is where I would insert it later.
To make this work easily I decided to store a numeric representation
of each date in the list in the id attribute
of each <li> element. Fortunately javascript natively stores dates as the number
of milliseconds since 1 Jan 1970.
var dateInMillisecs = selectedDate.valueOf();
Please note that this is the value
of the date in UTC! I always like to store dates in UTC as I learnt a long
time ago that it saves a lot
of refactoring at a later date... When I convert the dates back to their original back on the server I will need the UTC offset that was used when calculating the dates, this and how to actually serialise the dates and get them posted back will be the subject
of another post.
