No commit activity in last 3 years
No release in over 3 years
Integrates the Semantic UI pagination component with will_paginate
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

Runtime

 Project Readme

Will Paginate for Semantic UI

Gem Version Code Climate Coverage Status Travis

If you are using Will Paginate gem and Semantic UI framework, this gem is WHAT YOU NEED!

The html snippet for pagination that will_paginate creates is incompatible with the semantic ui.

This gem solves this problem with a custom render that creates the correct pagination html for the component.

Example Example

Requirements

Semantic UI > 2.0 and will_paginate > 3.0

Installation

As easy as gem install will_paginate_semantic_ui or add gem "will_paginate_semantic_ui" to your Gemfile

How to use

Rails

In your paginated view, you need to use another render in the will paginate command:

<%= will_paginate @collection, renderer: WillPaginateSemanticUi::ActionView::Renderer %>

Sinatra

require "will_paginate_semantic_ui" in your Sinatra app.

In your paginated view, you need to use another render in the will paginate command:

<%= will_paginate @collection, renderer: WillPaginateSemanticUi::Sinatra::Renderer %>

Look the example implementation at docs/sinatra_example

Example

To run the example:

cd docs/sinatra_example
bundle install
rackup

Tuning

You can also use some will_pagination options to customize your component:

<%= will_paginate @collection, renderer: WillPaginateSemanticUi::ActionView::Renderer, class: "right floated", inner_window: 3 %>

The command above create this

Example

inner_window: 3 as you see above, 3 pages to the left and to the right from the selected page. (This creates a component with 700px max width in the worst case)

Example

class: "right floated" useful if you are using inside a table. Floats the pagination to the right.

Contributing

First of all, thank you for wanting to help!

  1. Fork it.
  2. Create a feature branch - git checkout -b more_magic
  3. Add tests and make your changes
  4. Check if tests are ok - rake spec
  5. Commit changes - git commit -am "Added more magic"
  6. Push to Github - git push origin more_magic
  7. Send a pull request! ❤️