[Cocoon Wiki] Update of "Repository/DateTime" by JCKermagoret

[Apache Wiki <wi...@apache.org>]

Dear Wiki user,

You have subscribed to a wiki page or wiki category on "Cocoon Wiki" for change notification.

The following page has been changed by JCKermagoret:
http://wiki.apache.org/cocoon/Repository/DateTime

New page:
DateTime widget

= Intent =
A widget that permits you to select a date and a time too, in the same container.

= Motivation =
There is a date widget, from mattkruse lib. It's a very useful one, but there is a lack of time support to select a schedule.

There are other solutions, like the one from www.dynarch.com, but it's LGPL, not ASL.

So, I added time support to the mattkruse calendar widget.

= Feature =
The date time widget may be customized a little :
 * enable/disable the behavior
 * seconds and minutes may be incremented by steps

It looks like this :

[http://www.bluexml.org/static/images/scr-datetime.gif]

= Implementation =

The CP_tmpReturnFunction(y,m,d) function has been redesigned in function CP_tmpReturnFunction(y,m,d,hh,mm,ss) to manage time information.

2 functions have been written :
 * one to update the links in the calendar view
 * one to display the dropdowns

A few lines have been added too to manage initialization.

== Patch ==
The patch is available here :
I first need to discover how to make a patch with Eclipse :-)

= Usage =
In form definition, a date field is declared, and the display format wanted too.

{{{
<fd:field id="dtstart">
    <fd:datatype base="date">
        <fd:convertor>
          <fd:patterns>
            <fd:pattern>dd/MM/yyyy HH:mm:ss</fd:pattern>
          </fd:patterns>
        </fd:convertor>
    </fd:datatype>
</fd:field>
}}}

To avoid problem while manipulating dates between different applications, I use standart date time formats for storage. So, in the binding file, I have the following convertor :

{{{
<fb:value id="dtstart" path="dtstart">
    <fd:convertor datatype="date" type="formatting" variant="datetime">
        <fd:patterns>
            <fd:pattern>yyyy-MM-dd'T'HH:mm:ss.SSSZ</fd:pattern>
        </fd:patterns>
    </fd:convertor>
</fb:value>
}}}

To conclude, the mattkruse lib is initialized :
{{{
<script type="text/javascript" src="resources/forms/mattkruse-lib/mattkruse-lib.js"></script>
<script type="text/javascript" src="resources/forms/mattkruse-lib/CalendarPopup.js"></script>
<script type="text/javascript">
    // Setup calendar
    var forms_calendar = CalendarPopup(175,180);
    forms_calendar.setWeekStartDay(1);
    forms_calendar.showYearNavigation();
    forms_calendar.showYearNavigationInput();
    // New definition to display DateTimeDropdowns
    forms_calendar.showDateTimeDropdowns();
    forms_calendar.setCssPrefix("forms_");
</script>
<link rel="stylesheet" type="text/css" href="resources/forms/css/forms-calendar.css"/>
}}}

= More information =
This web page is available in html format on http://www.bluexml.org.
You may have help on cocoon or bluexml mailing lists.

["JCKermagoret"]