jvang2003 / ui_datepicker-rails3

jQuery UI datepicker integration for Formtastic, Simple Form and Active Admin

jQuery UI Datepicker for Rails 3.x

This gem adds support for jQuery UI Date and DateTime picker for Rails 3.x form builders, including:

• Formtastic 2.x+
• SimpleForm
• ActiveAdmin 0.4+

Feel free to provide patches/extensions to support other form builders.

Install

Insert into Gemfile:

gem 'ui_datepicker-rails3'

Activate it like this:

UiDatePickerRails3.activate :simple_form

This can be done fx from inside an initializer. You can pass either :simple_form, :formtastic or :active_admin to the #activate method.

jQuery UI Configuration

For basic Rails form builder support, please see "jquery_datepicker"

In Gemfile, insert:

gem 'jquery-rails'

Then install jquery with UI, by executing the following command from console:

rails generate jquery:install --ui

In Rails 3.1 when using the asset pipeline, this generator is deprecated, so you’ll need to add a line to your app/assets/javascripts/application.js file:

//= require jquery-ui

Formtastic

This gem requires Formtastic 2.0+.

Note: For a version that supports Formtastic < 2.0, see [formtastic_datepicker]:(https://github.com/kristianmandrup/formtastic_datepicker)

ActiveAdmin

The ActiveAdmin extension should work with ActiveAdmin 0.4+ (Formtastic >= 2.0)

Formtastic (by justinfrench)

The gem adds a couple of new form inputs to Formtastic that can be used like this:

<% semantic_form_for @person do |f| -%>
  <% f.inputs do -%>
    <%= f.input :name %>
    <%= f.input :born, :as => :ui_date_picker %>
  <% end -%>
  <%= f.buttons %>
<% end -%>

The Formtastic Input class adds class='ui-date-picker' to the text input, which can the be matched by jQuery and converted to the date picker widget.

<% semantic_form_for @person do |f| -%>
  <% f.inputs do -%>
    <%= f.input :name %>
    <%= f.input :born, :as => :ui_date_time_picker %>
  <% end -%>
  <%= f.buttons %>
<% end -%>

The Formtastic Input class adds class='ui-datetime-picker' to the text input, which can the be matched by jQuery and converted to the date-time picker widget.

SimpleForm (by plataformatec)

The gem adds a couple of new form inputs to SimpleForm that can be used like this:

<% simple_form_for @person do |f| -%>
  <%= f.input :name %>
  <%= f.input :born, :as => :ui_date_picker %>
<% end -%>

The SimpleForm Input class adds class='ui-date-picker' to the text input, which can the be matched by jQuery and converted to the date picker widget.

<% simple_form_for @person do |f| -%>
  <%= f.input :name %>
  <%= f.input :born, :as => :ui_date_time_picker %>
<% end -%>

The SimpleForm Input class adds class='ui-datetime-picker' to the text input, which can the be matched by jQuery and converted to the date-time picker widget.

Configuration

These configuration tips are only appropriate for a static datepicker, i.e one with a fixed set of options and a given language. Handling a more dynamic configuration is left as an exercise.

When the gem has been installed the datepicker should be configured as follows

Install the jquery-ui CSS. You can get a bundle to match your site from ThemeRoller. From your theme bundle, extract the CSS directory and place it somewhere under app/assets/stylesheets/.

Activate datepicker on all matching input elements in one of your javascript (or coffee script) files, fx datepicker.js or datepicker.js.coffee.

$(document).ready(function(){
  $('input.ui-date-picker').datepicker();
  $('input.ui-datetime-picker').datetimepicker();
});

The same in coffescript:

$ ->
  $('input.ui-date-picker').datepicker()
  $('input.ui-datetime-picker').datetimepicker()

You can even include an premade script included as ui_datepicker.js (which executes the above code), or customize the initialization to fit your needs: Using the asset pipeline, simply add:

//= require ui_datepicker

Localization (optional)

To add localization, you can additionally add localization options to the datepicker() call.

Example: Using the swedish localization:

$(document).ready(function(){
  $('input.ui-date-picker').datepicker('option', 'sv' );
});

The same in coffescript:

$ ->
  $('input.ui-date-picker').datepicker('option', 'sv')

For any other language exchange the local 'sv' to the appropriate (localized) country code.

Copy the appropriate localization file from "jQuery-UI i18n" to your js asset folder, fx at: app/assets/javascripts/i18n/jquery.ui.datepicker-sv.js

Then make sure a reference to the locale file is added in the manifest file.

//= require i18n/jquery.ui.datepicker-sv to your js manifest file.

You can also use the included datepicker locale files as a base (see vendor/assets of this gem). This gem includes a helper method #ui_localizers that can be used like this (fx in your Rails layout file or similar):

<%= javascript_include_tag UiDatePickerRails3.ui_localizers :ar, :ca, :da %>

It will generate strings of the form "ui/i18n/jquery.ui.datepicker-#{country_code}"

Styling (optional)

Style the datepicker by adding a datepicker.css file to your css assets.

You can use the Themeroller (http://jqueryui.com/themeroller/) to define and download an appropriate css file and the pictures needed. Add the downloaded Themeroller css file to the css assets and add the Themeroller images to the image assets. Edit the datepicker css and change all image references by removing all the "images/" prefixes e.g from url(images/ui-icons_222222_256x240.png) to url(ui-icons_222222_256x240.png)

Note: It is also possible to load only the js needed for the datepicker widget by using the js files that are downloaded from Themeroller.

A 'smoothness' theme is included with this gem. Simply add to application.css:

/*
 *= require ui/smoothness/jquery-ui-theme
*/

Advanced configuration

Add any additional datepicker options as defined in the "Datepicker" docs.

Example: add option for displaying week number and displaying a drop-down of months:

$(document).ready(function(){
  var datepicker_widgets = $('input.ui-date-picker');

  datepicker_widgets.datepicker( 'option', 'showWeek', true);
  datepicker_widgets.datepicker( 'option', 'changeMonth', true );
});

ActiveAdmin integration

In the Gemfile add this gem after ActiveAdmin (gem 'active_admin') to make sure it loads after and overrides/extends ActiveAdmin appropriately.

gem 'active_admin'
gem 'ui_datepicker-rails3'

Note: To configure css and js files with ActiveAdmin you can use the config DSL in the ActiveAdmin initializer.