Handlebars Routes

🔬 This was an experiment to see if I could translate Rails routes into something useable on the client side.

Its totally do-able but there are some major security implications to exposing ALL of your routes client side.

I'm no longer using this library, so hopefully it will serve as inspiration to someone else.

Installing

Bundle it

gem 'handlebars_routes', '~> 0.0.1'

Sprockets require it (in app/assets/javascripts/application.(js|coffee) for example):

//= handlebars_routes

The link_to helper uses underscore.js templating and assumes you have put it into "mustache mode"

# Setup underscore's templating to use Mustache style templates
_.templateSettings =
  interpolate: /\{\{(.+?)\}\}/g

What it does

Its really annoying not to have all your Rails routes on the client side especially when you're doing Javascript templating. This gem aims to fix that by dumping your rails routes into a rails_routes object in javascript.

I've added my Handlebars Helpers router and link_to. The link_to helper uses the router helper to create links in Handlebars templates very much like creating links in Rails templates.

The router will traverse your object looking for the right attributes to put into the route. You could also use these routes in Backbone models' urls, haven't tried it yet but its a thought.

Examples are probably better eh?

Given the Rails routes:

resources :items do
  resources :products
end

Given the data (a Backbone like object):

item = { attributes: {
           id: 42, 
           product: {id:24, title: 'Pugs not Drugs'}, 
           item_code: "PUGS", 
           created_at:'11/11/2011'      
          }
       }

And the template item/show.jst.hbs (notice the triple-stache around link_to). "item_product" is the route that Rails provided. The list of routes are stored in the rails_routes global javascript object. Take a look at it in Inspector to find specific routes.

<tr>
  {{#attributes}}
    <td>{{{link_to product.title "item_product"}}}</td>
    <td> {{item_code}}  </td>
    <td> {{created_at}}</td>
  {{/attributes}}
</tr>

And this coffeescript Backbone View:

class ItemView extends Backbone.View
  # ...

  render: =>
    $(@el).prepend JST['item/show'] @model

  # ...
end

This awesome looking html will be produced!!!

<tr>
  <td><a href="/items/42/products/24">Pugs not Drugs</a</td>
  <td>PUGS</td>
  <td>11/11/2011</td>
</tr>