Kaminari

hideThis article has multiple issues. Please help or discuss these issues on the talk page. (Learn how and when to remove these template messages) This article is an orphan, as no other articles . Please introduce links to this page from ; try the Find link tool for suggestions. (October 2015) The topic of this article may not meet Wikipedia's general notability guideline. Please help to demonstrate the notability of the topic by citing reliable secondary sources that are independent of the topic and provide significant coverage of it beyond a mere trivial mention. If notability cannot be shown, the article is likely to be merged, redirected, or deleted. Find sources:  –  ·  ·  · scholar · JSTOR (October 2015) (Learn how and when to remove this template message) This article needs additional citations for verification. Please help by adding citations to reliable sources. Unsourced material may be challenged and removed. Find sources:  –  ·  ·  · scholar · JSTOR (October 2015) (Learn how and when to remove this template message) This article relies too much on references to primary sources. Please improve this by adding secondary or tertiary sources. (October 2015) (Learn how and when to remove this template message) (Learn how and when to remove this template message)

Kaminari (雷) is a paginating tool written in Ruby. gem compatible with Rails versions 3.0 thunder. It was developed by ^[1] along with ,^[2] ,^{[3] [4]} in 2011.^[5][6]

History[]

雷 (kaminari, kannari, ikazuchi, narukami, rai): thunder.

The first commit to the Git repository was made by Akira Matsuda on February 5, 2011 with the comment "Initial commit to kaminari."^[7] On February 6, 2011 he released the first version 0.1.0, with the commit comment "Version bump to 0.1.0".^[8] The latest stable release is 1.2.1 available from May 28, 2020.^[9]

Features[]

hideThis section has multiple issues. Please help or discuss these issues on the talk page. (Learn how and when to remove these template messages) This section contains content that is written like an advertisement. Please help by removing promotional content and inappropriate external links, and by adding encyclopedic content written from a neutral point of view. (October 2015) (Learn how and when to remove this template message) This article needs attention from an expert in section. Please add a reason or a talk parameter to this template to explain the issue with the article. may be able to help recruit an expert. (October 2015) (Learn how and when to remove this template message)

^[10]

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.^[11]

Wide support[]

Kaminari has active support for various ORMs like Active Record, .^[12] It also supports web-frameworks like Rails, Sinatra, Grape and template engines like eRuby, Haml, Slim.^[13]

HTML5 integration[]

Kaminari is actively updated and as such it has support for HTML5. It outputs the HTML <nav> tag by default.

Supported software/languages[]

^[14]

• Ruby 2.0.0, 2.1.x, 2.2.x, 2.3.x, 2.4.x, 2.5.x, 2.6.x, 2.7.x, 2.8
• Rails 4.1, 4.2, 5.0, 5.1, 5.2, 6.0, 6.1
• Sinatra 1.4, 2.0
• Haml 3+
• Mongoid 3+
• MongoMapper 0.9+
• DataMapper 1.1.0+

References[]

External links[]

• kaminari on GitHub
• Akira Matsuda
• Yuki Nishijima
• Zachary Scott
• Hiroshi Shibata
• Mongoid
• Slim-template