Project
bjeanes-livedate
= Livedate
A simple Rack middleware that parses a dates using Chronic, and
returns the result in a standardized manner. The idea is to use
this to verify the input in date input fields using AJAX, to
provide immediate feedback to the user.
== Usage
Include Livedate in your middleware stack. In Rails, this
is done in environment.rb
config.gem 'livedate'
config.middleware.use "Livedate"
Specify the desired date + datetime formats you want too. Default
error message for strings that Chronic can't pass can also
be provided. The defaults are:
config.middleware.use "Livedate",
:date_format => '%Y-%m-%d',
:datetime_format => ''%Y-%m-%d %H:%M',
:invalid_format => ''
This will catch requests to /parsedate. Use GET requests and
provide a parameter 'date' or 'datetime'. The value will be
parsed by Chronic and returned formatted as 2009-01-01 or
2009-01-01 12:45, depending on the parameter name.
== Scripts
There are two generators available to get simple javascripts
that use livedate. Both will replace the contents on input
elements with classes .date or .datetime on change with the
result from the Chronic parse.
script/generate livedate_jquery
script/generate livedate_prototype
Will put the appropriate version of the script in your
public/javascripts directory. Feel free to change these
if you need a different behavior.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
Development
Dependencies
Runtime
>= 0.2.3