bootstrap_datepicker's Introduction

Bootstrap Datepicker Rails plugin¶ ↑

This gem allows you to use a beautifull twitter-bootstrap themed date picker on date fields via a simple form helper.

This gem packs Stefan Petre’s amazing jQuery/Bootstrap plugin (www.eyecon.ro/bootstrap-datepicker/) with a simple Rails interface.

Getting Started¶ ↑

for Rails >= 3.1:

Insert into your Gemfile:
```
gem 'bootstrap_datepicker'
```
If you are using Rails 3.1 with the asset pipeline enabled (default), the necessary files are already in your asset pipeline.

Just add (if they are not already there) to your app/assets/javascripts/application.js:

//= require jquery
//= require jquery-ujs
//= require jquery-ui
//= require twitter/bootstrap
//= require bootstrap-datepicker

The same applies for app/assets/stylesheets/application.css

*= require bootstrap-datepicker

Usage¶ ↑

Add this to your view.

<%= datepicker_input "user", "birthday" %>

Where “user” is your model name and “birthday” the name of the datefield.

You can also use it with the form helper like:

<% form_for(@user) do |f| %>
  <%= f.datepicker 'birthday' %>
  <%= f.submit 'Create' %>
<% end %>

Nested attributes are permitted as well:

<% form_for(@user) do |f| %>
  <% f.fields_for(@nested) do |f2| %>
    <%= f2.datepicker 'birthday' %>
  <% end %>
  <%= f.submit 'Create' %>
<% end %>

You can pass options as it would be a normal text_field, plus all the datepicker options available (www.eyecon.ro/bootstrap-datepicker/)

<%= datepicker_input(:foo, :att1,
        :format => 'mm/dd/yy',
        :week_start => 0, 
        :view_mode => 'years', 
        :min_view_mode => 'days') %>