Kaminari
Developer | Akira Matsuda, Yuki Nishijima, Zachary Scott, Hiroshi Shibata |
---|---|
First appeared | Feb 6, 2011 |
OS | Cross-platform |
License | MIT license |
Website | kaminari on GitHub |
Search Kaminari on Amazon.
Kaminari (雷) is a paginating tool written in Ruby. gem compatible with Rails versions 3.0 thunder. It was developed by Akira Matsuda[1] along with Yuki Nishijima,[2] Zachary Scott,[3] Hiroshi Shibata[4] in 2011.[5][6]
History[edit]
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[edit]
User-friendly[edit]
Just by bundling the gem, the models of the project can be paginated without the need for any configuration. The page
function just needs to be called inside the controller.[10]
Clean[edit]
Kaminari doesn't pollute the global namespace while using Array
, Hash
, Object
or ActiveRecord::Base
.
Simple scope based[edit]
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[edit]
Kaminari has active support for various ORMs like Active Record, Mongoid.[12] It also supports web-frameworks like Rails, Sinatra, Grape and template engines like eRuby, Haml, Slim.[13]
HTML5 integration[edit]
Kaminari is actively updated and as such it has support for HTML5. It outputs the HTML <nav> tag by default.
Supported software/languages[edit]
- 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[edit]
- ↑ "amatsuda (Akira Matsuda)". GitHub.
- ↑ "yuki24 (Yuki Nishijima)". GitHub.
- ↑ "zzak (Zachary Scott)". GitHub.
- ↑ "hsbt (SHIBATA Hiroshi)". GitHub.
- ↑ "All versions of kaminari | RubyGems.org | your community gem host". rubygems.org. Retrieved 2015-09-15.
- ↑ "kaminari | RubyGems.org | your community gem host". rubygems.org. Retrieved 2015-09-15.
- ↑ "Initial commit to kaminari. · amatsuda/kaminari@4db3397". GitHub. Retrieved 2015-09-15.
- ↑ "Version bump to 0.1.0 · amatsuda/kaminari@e1bd7b7". GitHub. Retrieved 2015-09-15.
- ↑ "Release v1.2.1 · kaminari/kaminari". GitHub. Retrieved 2021-03-11.
- ↑ "kaminari/README.rdoc". GitHub. Archived from the original on 2014-08-27. Retrieved 2015-09-15. Unknown parameter
|url-status=
ignored (help) - ↑ "ASCIIcasts - "Episode 254 - Pagination with Kaminari"". asciicasts.com. Archived from the original on 2015-09-26. Retrieved 2015-09-16. Unknown parameter
|url-status=
ignored (help) - ↑ "Mongoid". GitHub.
- ↑ "Slim Template Language". GitHub.
- ↑ "kaminari/README.md". GitHub. Retrieved 2021-03-11.
External links[edit]
This article "Kaminari" is from Wikipedia. The list of its authors can be seen in its historical and/or the page Edithistory:Kaminari. Articles copied from Draft Namespace on Wikipedia could be seen on the Draft Namespace of Wikipedia and not main one.