Hidden Features of Ruby on Rails

To avoid duplicate form submissions, Rails has a nice option for submit tags:

submit_tag "Submit", :disable_with => "Saving..."

This adds behavior to the submit button to disable it once clicked, and to display "Saving..." instead of "Submit".

Rails 4+

 DEPRECATION WARNING: :disable_with option is deprecated and 
 will be removed from Rails 4.1. Use 'data: { disable_with: 'Text' }' instead.

Thus the above becomes:

submit_tag 'Submit', data: { disable_with: 'Text' }

integer.ordinalize is one little method that I just stumbled upon not to long ago.

1.ordinalize = "1st"
3.ordinalize = "3rd"

I'm currently in love with div_for and content_tag_for

<% div_for(@comment) do %>
  <!-- code to display your comment -->
<% end %>

The above code renders this:

<div id="comment_123" class="comment">
  <!-- code to display your comment -->
</div>

Want the CSS class to be comment other_class? No problem:

<% div_for(@comment, :class => 'other_class') do %>
  <!-- code to display your comment -->
<% end %>

Want a span and not a div? No problem, content_tag_for to the rescue!

<% content_tag_for(:span, @comment) do %>
<% end %>

# Becomes...

<span id="comment_123" class="comment">
  <!-- code to display your comment -->
</span>

content_tag_for is also great if you want to prefix you id. I use it for loading gifs.

<% content_tag_for(:span, @comment, 'loading') do %>
  <%= image_tag 'loading.gif' -%>
<% end %>

# Becomes...

<span id="loading_comment_123" class="comment">
  <img src="loading.gif" />
</span>

To see a list of gems that are installed, you can run:

gem server

Then point your browser at:

http://localhost:8808

You get a nicely formatted list of your gems with links to rdoc, the web and any dependencies. Much nicer than:

gem list

You can take advantage of the fact that Ruby class definitions are active and that Rails caches classes in the production environment, to ensure that constant data is only fetched from the database when your application starts up.

For example, for a model that represents countries you'd define a constant that performs a Country.all query when the class is loaded:

class Country < ActiveRecord::Base
  COUNTRIES = self.all
  .
  .
  .
end

You can use this constant within a view template (perhaps within a select helper) by referring to Country::COUNTRIES. For example:

<%= select_tag(:country, options_for_select(Country::COUNTRIES)) %>

in your environment.rb, you can define new date/time formats e.g.

[Time::DATE_FORMATS, Date::DATE_FORMATS].each do |obj|
  obj[:dots] = "%m.%d.%y"
end

so then in your views you can use:

Created: <%= @my_object.created_at.to_s(:dots) %>

which will print like:

Created: 06.21.09

If you have a model with some class methods and some named scopes:

class Animal < ActiveRecord::Base
  named_scope 'nocturnal', :conditions => {'nocturnal' => true}
  named_scope 'carnivorous', :conditions => {'vegetarian' => true}

  def self.feed_all_with(food)
    self.all.each do |animal|
      animal.feed_with(food)
    end
  end
end

Then you can call the class methods through the named scope:

if night_time?
  Animal.nocturnal.carnivorous.feed_all_with(bacon)
end

Rails 2.3.x now allows you to do:

render @items

much simpler..

I'll start with one of my favorites. When calling a partial with a collection, instead of looping through your collection and calling it for each item, you can use this:

render :partial => 'items', :collection => @items

This will call the partial once per item, and pass a local variable item each time. You don't have to worry about nil checking @items either.

If you add routing for a resource:

ActionController::Routing::Routes.draw do |map|
  map.resources :maps
end

And register additional mime-types:

Mime::Type.register 'application/vnd.google-earth.kml+xml', :kml

You don't need a respond_to block in your controller to serve these additional types. Instead, just create views for the specific types, for example 'show.kml.builder' or 'index.kml.erb'. Rails will render these type-specific templates when requests for '/maps.kml' or '/maps/1.kml' are received, setting the response type appropriately.

ActionView::Base.default_form_builder = MyFormBuilderClass

Very useful when you're creating your own form builders. A much better alternative to manually passing :builder, either in your views or in your own custom_form_for helper.

Get everything printed with rake routes programmatically:

Rails.application.routes