Sorting tables in Rails is a common problem. It must have been done before, right? In fact it has been done so many times that it’s really hard to find anything that “just works”. Turned out to waste a lot of time of at least two people with creative libraries that fall short in many rather trivial ways. Of the good ones, a colleague tried sortable_table, but it’s not maintained and we finally settled on the much better handles_sortable_columns, which needed a tiny bit of integration work for Mongoid.
Let’s make all our controllers support sorting with the sort_by parameter. Add the following to your ApplicationController.
This lets us add column sorting with sortable_column to a view (views/tags/index.html.haml).
We can use sorting on a Mongoid model directly. For a Tag model, this means invoking
Tag.asc(:field) by name.
There’re several issues with this.
We’ve just enabled parameter injection where one can send all kinds of wonderful queries into the Mongoid model by editing the URL. There’s no clear default sorting, for tags we’d like to sort by count in descending order.
The first issue can be solved by checking whether the direction is one of :asc or :desc and whether a column is a field in the model (added to config/initializers/mongoid_document.rb).
nil if no sorting has been done, we can use it to introduce a default sort in the Tags controller.
I love the attention to detail with the little arrow next to the sorted column as well as the fact that this gem uses the –column syntax for sorting in descending order. It also properly supports pagination. Well done.