Giter VIP home page Giter VIP logo

datatables-rails-bs3's Introduction

datatables-rails-bs3

This gem packages the jQuery DataTables plugin for easy use with the Rails 3.1+ asset pipleine.

It provides all the basic DataTables files, and a few of the extras.

Twitter Bootstrap 3 Installation

  1. Add to your Gemfile:

     gem 'datatables-rails-bs3'
    
  2. Install the gem:

     bundle install
    
  3. Add the JavaScript to application.js:

     //= require dataTables/jquery.dataTables
     //= require dataTables/jquery.dataTables.bootstrap
    
  4. Add the stylesheets to application.css:

     *= require dataTables/jquery.dataTables.bootstrap
    
  5. Initialize your datatables using one of these options:

// Default Type
$('.datatable').dataTable({
  "sPaginationType": "bs_normal"
});
// Two Buttons
$('.datatable').dataTable({
  "sPaginationType": "bs_two_button"
});
// Four Buttons
$('.datatable').dataTable({
  "sPaginationType": "bs_four_button"
});
// Full
$('.datatable').dataTable({
  "sPaginationType": "bs_full"
});

Plugins

Only a few plugins are currently available

  • api
    • fnReloadAjax
    • fnGetColumnData
    • fnFilterOnReturn
    • fnSetFilteringDelay
  • sorting
    • numbersHtml
  • typeDetection
    • numberHtml

These files can be found in the assets directory.

Extras

Only the official extras are available:

  • AutoFill
  • ColReorder
  • ColVis
  • FixedColumns
  • FixedHeader
  • KeyTable
  • Scroller
  • TableTools

To add an extra into your application, add its JS file to application.js using the following pattern:

//= require dataTables/extras/[ExtraName]

Additionally, you may need to add any associated CSS files. For instance the TableTools extra requires you to add the following two lines to your application.css file:

*= require dataTables/extras/TableTools
*= require dataTables/extras/TableTools_JUI

Make sure to also add it's initialization as described on datatables extras' site

datatables-rails-bs3's People

Contributors

colvint avatar genkilabs avatar matfiz avatar mchapman17 avatar meidan1984 avatar noirbizarre avatar rweng avatar s-andringa avatar superscott avatar wjgilmore avatar zencocoon avatar

Stargazers

 avatar  avatar

Watchers

 avatar  avatar  avatar

Forkers

nightweb

datatables-rails-bs3's Issues

Sortable Arrow Images Not Showing

Currently the sortable arrow images are not showing. This could be a relative path issue because of the asset pipeline or some type of styling problem.

Sortable Arrow Images Not Showing

I use datatables-rails-bs3 with my Rails 4 project, and I got an exception in production mode.

GET http://www.pandacourse.com/assets/datatables/sort_asc.png 404 (Not Found) admin-e14a70de3039aadeed15c39473a436ad.js:2
GET http://www.pandacourse.com/assets/datatables/sort_both.png 404 (Not Found) admin-e14a70de3039aadeed15c39473a436ad.js:2

In admin.js there are just 2 lines.

//= require dataTables/jquery.dataTables
//= require dataTables/jquery.dataTables.bootstrap

And I have added admin.js to Rails.application.config.assets.precompile

Rails.application.config.assets.precompile += %w( html5shiv.min.js respond.min.js admin.js )

Now, to fix this, I have to add following lines to my css file:

table.table thead .sorting { background: image-url('datatables/sort_both.png') no-repeat center right; }
table.table thead .sorting_asc { background: image-url('datatables/sort_asc.png') no-repeat center right; }
table.table thead .sorting_desc { background: image-url('datatables/sort_desc.png') no-repeat center right; }

table.table thead .sorting_asc_disabled { background: image-url('datatables/sort_asc_disabled.png') no-repeat center right; }
table.table thead .sorting_desc_disabled { background: image-url('datatables/sort_desc_disabled.png') no-repeat center right; }

Use image-url instead of url, and add all image filenames to precompile

Rails.application.config.assets.precompile += %w( html5shiv.min.js respond.min.js admin.js 
  datatables/sort_both.png datatables/sort_asc.png datatables/sort_desc.png 
  datatables/sort_asc_disabled.png datatables/sort_desc_disabled.png )

It works.

But I think it's better to be done in your engine file.

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.