better_partials¶ ↑

Provides syntactic sugar for render :partial.

Examples¶ ↑

Render a partial¶ ↑

<%= partial "people/search_box" %>

Pass some parameters in¶ ↑

<% form_for @person do |f| %>
  <%= partial "people/form", :f => f %>
<% end %>

Pass in a collection¶ ↑

<%= partial "people/person", :collection => @people %>

Or the terse way…

<%= partials @people %>

Also works, but not as nice reading…

<%= partial @people %>

Rendering a block¶ ↑

<% partial "people/box" do %>
  Inner content goes here.. (gets called in your partial's yield statement)
<% end %>

Special Options ¶ ↑

These special options pass through to render :partial. All others are passed through as :locals.

:collection
:spacer_template
:object
:use_full_path

Installation¶ ↑

Install Plugin¶ ↑

script/plugin install git://github.com/jcnetdev/better_partials.git

Install Gem¶ ↑

If you’re using Rails 2.1, you -can- should use the plugin as a gem.

Add this to your environment.rb:

config.gem 'jcnetdev-better_partials', :version => '>= 1.1.3', :lib => 'better_partials', :source => 'http://gems.github.com'

To install:

rake gems:install

To unpack:

rake gems:unpack

Copyright © 2008 Jacques Crocker (www.railsjedi.com), released under the MIT license