$.urlchange() triggers custom events when the URL changes. This makes it easy to build URL-driven applications.

Suppose we have buttons that sort based on “City” or “Sales”. These are usually bound directly to DOM events like this:

<!-- DO NOT DO THIS -- this example shows a BAD practice -->
<button class="sort">City</button>
<button class="sort">Sales</button>
  $('.sort').on('click', function(e) { action($(this).text()) })

Problem: In the example above, the sort is lost when the page is reloaded.

Solution: DOM events should not trigger actions directly. DOM events should change the URL like this:

<button href="?_sort=City" class="urlfilter" target="#">City</button>
<button href="?_sort=Sales" class="urlfilter" target="#">Sales</button>

Now, changes in the URL should trigger actions:

  .on('#?city', function(e, city) { action(city) })   // Listen to #? events
  .urlchange()                                        // Enable these events


$.urlchange events