First appeared Feb 6, 2011 License MIT license | OS Cross-platform Website kaminari on GitHub | |
 | ||
Developer Akira Matsuda, Yuki Nishijima, Zachary Scott, Hiroshi Shibata Stable release 0.16.2 / January 20, 2015 | ||
Kaminari (雷) is a paginating tool written in Ruby. It is a Ruby gem compatible with Rails versions 3.0 and above. The word Kaminari is a Japanese word meaning thunder. It was developed by Akira Matsuda along with Yuki Nishijima, Zachary Scott, Hiroshi Shibata in 2011.
Contents
History
The first commit to the Git repository was made by Akira Matsuda on February 5, 2011 with the comment "Initial commit to kaminari." On February 6, 2011 he released the first version 0.1.0, with the commit comment "Version bump to 0.1.0". The latest stable release is 0.16.2 available from January 20, 2015.
User-friendly
Just by bundling the gem, the models of the project can be paginated without the need for any configurations.The page function just needs to be called inside the controller.
Clean
Kaminari doesn't pollute the global namespace while using Array, Hash, Object or ActiveRecord::Base.
Simple scope based
Kaminari can be used with just an instance of the class ActiveRecord::Relation without the use of any special class, module or anything for the paginated values.It also supports method chaining and chaining can be done before or after the pagination scope.An exception to this behavior is that the per method needs to be called after the page method as the page method creates its scope.
Wide support
Kaminari has active support for various ORMs like Active Record, Mongoid. It also supports web-frameworks like Rails, Sinatra, Grape and template engines like eRuby, Haml, Slim.
HTML5 integration
Kaminari is actively updated and as such it has support for HTML5. It outputs the HTML <nav> tag by default.