Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Makes the jQuery UI sortable behavior a little friendlier, especially if you're using acts_as_list
JavaScript
branch: master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
lib
README.textile

README.textile

singular_sortable

singluar_sortable is a jQuery UI plugin for enhancing the behavior of the jQuery UI sortable Interaction.

The Problem

Sortable is very nice, but it tends to treat the sorted elements as one lump group. The recommended way of dealing with the sorting event is to serialize the entire list and send it back to the server for processing.

But, if you’re using the Rails acts_as_list plugin (or something similar) to handle position info, then you’ve already got a powerful way of handling sorting on the backend. All you really need to know is the new integer position value for the moved item.

The Solution

singular_sortable will automatically do all the position calculation on the client side and determine the new position value to be sent to the server for only the singular item that was moved.

Requirements

  • jQuery
  • jQuery UI
  • HTML5 – singular_sortable uses the new HTML5 data- attributes, but only as a way to store the data. There’s no assumption of the underlying support for retrieving the values. Instead, jQuery is used for that. In other words, it will work in all browsers, but if your DOCTYPE isn’t HTML5, then validators will complain.

Usage

You will need to add an attribute to each draggable sort item containing the object’s position value. We recommend using the new HTML5 data- attributes, as this is a way to do it with valid HTML. Otherwise, it will be technically invalid, but should still work.

Example HTML

<ul id='my-sortable'>
  <li data-position='1'>Your first item.</li>
  <li data-position='2'>Your second item.</li>
  <li data-position='3'>And so on...</li></ul>

The javascript

jQuery('#my-sortable').sortable({
  }).singular_sortable({
    positionAttribute : 'data-position',
    update : function(e, ui) {
      var newPositionValue = ui.numericalPosition;
      // Now, you can use an AJAX call to send the new position back to the server, no messing with toArray or serialize
    }
  });

What it’s doing

singluar_sortable borrows heavily from acts_as_list for inspiration. It maintains the position information in an attribute on the sort items. When an item is moved, the position values are recalculated and updated with the new sort ordering.

Sorting paginated lists

The inspiration for this came from trying to sort a paginated list. By using the actual position values from the database, you will be able to easily sort items within a single page of a paginated list, since you’re using their absolute position values in the list. There’s currently no support for sorting an item onto a different page, but I’m trying to figure out a good way to do this. Still, that’s probably outside the scope of singular_sortable

Something went wrong with that request. Please try again.