This gem packages the jQuery DataTables plugin for easy use with the Rails 3.1+ asset pipleine.
It provides all the basic DataTables files, but not (yet) the extras.
- Add
gem 'jquery-datatables-rails'
to the assets group in your Gemfile and runbundle install
. - Add the JavaScript to
application.js
:
//= require dataTables/jquery.dataTables
- Add the stylesheets to
application.css
:
*= require dataTables/jquery.dataTables
- Add the JavaScript to
application.js
:
//= require dataTables/jquery.dataTables.bootstrap
- Remove the initial stylesheets from
application.css
- Add the stylesheets to
application.css
:
*= require dataTables/jquery.dataTables.bootstrap
- Initialize your datatables like this:
// For fluid containers
$('.datatable').dataTable({
"sDom": "<'row-fluid'<'span6'l><'span6'f>r>t<'row-fluid'<'span6'i><'span6'p>>",
"sPaginationType": "bootstrap"
});
// For fixed width containers
$('.datatable').dataTable({
"sDom": "<'row'<'span6'l><'span6'f>r>t<'row'<'span6'i><'span6'p>>",
"sPaginationType": "bootstrap"
});
Only a few plugins are currently available
- api
- fnReloadAjax
- fnGetColumnData
- fnSetFilteringDelay
- sorting
- numbersHtml
- typeDetection
- numberHtml
Check out the assets directory.
Only a few extras are currently available:
- FixedColumns
- FixedHeader
To add an extra into your application, include it like follow:
//= require dataTables/extras/[ExtraName]
Make sure to also add it's initialization as described on datatables extras' site