173
votes

I use a different layout for some actions (mostly for the new action in most of the controllers).

I am wondering what the best way to specify the layout would be? (I am using 3 or more different layouts in the same controller)

I don't like using

render :layout => 'name'

I liked doing

layout 'name', :only => [:new]

But I can't use that to specify 2 or more different layouts.

For example:

When I call layout 2 times in the same controller, with different layout names and different only options, the first one gets ignored - those actions don't display in the layout I specified.

Note: I'm using Rails 2.

7
The Rails Guides documentation: guides.rubyonrails.org/…Kevin
Good point. The documentation for Rails 2: guides.rubyonrails.org/v2.3.11/…Kevin
(Also, I posted the guide to help future readers. I have no doubt you had your problem solved a long time ago ;-)Kevin

7 Answers

309
votes

You can use a method to set the layout.

class MyController < ApplicationController
  layout :resolve_layout

  # ...

  private

  def resolve_layout
    case action_name
    when "new", "create"
      "some_layout"
    when "index"
      "other_layout"
    else
      "application"
    end
  end
end
209
votes

If you are only selecting between two layouts, you can use :only:

class ProductsController < ApplicationController
   layout "admin", only: [:new, :edit]
end

or

class ProductsController < ApplicationController
   layout "application", only: [:index]
end
51
votes

You can specify the layout for an individual action using respond_to:

  def foo
    @model = Bar.first
    respond_to do |format|
      format.html {render :layout => 'application'}
    end
  end
14
votes

You can also specify the layout for action using render:

def foo
  render layout: "application"
end
8
votes

There's a gem (layout_by_action) for that :)

layout_by_action [:new, :create] => "some_layout", :index => "other_layout"

https://github.com/barelyknown/layout_by_action

7
votes

Various ways to specify layout under controller:

  1. In following code, application_1 layout is called under index and show action of Users controller and application layout(default layout) is called for other actions.

    class UsersController < ApplicationController
      layout "application_1", only: [:index, :show]
    end
    
  2. In following code, application_1 layout is called for all action of Users controller.

    class UsersController < ApplicationController
       layout "application_1"
    end
    
  3. In following code, application_1 layout is called for test action of Users controllers only and for all other action application layout(default) is called.

        class UsersController < ApplicationController
          def test
            render layout: "application_1"
          end
        end
    
7
votes

Precision :

A not really but working DRY way is what you see above, but with a precision : the layout need to be after your variables for working ("@some"). As :

def your_action
   @some = foo
   render layout: "your_layout"
end

And not :

def your_action
   render layout: "your_layout"
   @some = foo
   @foo = some
end

If you do a before_action... it's won't work also.

Hope it helps.