mirror of
https://github.com/rails/rails.git
synced 2022-11-09 12:12:34 -05:00
b2600bfc18
This means that templates does not need to store its source anymore, allowing us to reduce the ammount of memory taken by our Rails processes. Naively speaking, if your app/views contains 2MB of files, each of your processes (after being hit by a bunch of requests) will take 2MB less of memory after this commit. This is extremely important for the upcoming features. Since Rails will also render CSS and JS files, their source won't be stored as well allowing us to decrease the ammount of memory taken.
83 lines
2.6 KiB
Ruby
83 lines
2.6 KiB
Ruby
module ActionView
|
|
# = Action View Layouts
|
|
module Layouts
|
|
# Returns the contents that are yielded to a layout, given a name or a block.
|
|
#
|
|
# You can think of a layout as a method that is called with a block. If the user calls
|
|
# <tt>yield :some_name</tt>, the block, by default, returns <tt>content_for(:some_name)</tt>.
|
|
# If the user calls simply +yield+, the default block returns <tt>content_for(:layout)</tt>.
|
|
#
|
|
# The user can override this default by passing a block to the layout:
|
|
#
|
|
# # The template
|
|
# <%= render :layout => "my_layout" do %>
|
|
# Content
|
|
# <% end %>
|
|
#
|
|
# # The layout
|
|
# <html>
|
|
# <%= yield %>
|
|
# </html>
|
|
#
|
|
# In this case, instead of the default block, which would return <tt>content_for(:layout)</tt>,
|
|
# this method returns the block that was passed in to <tt>render :layout</tt>, and the response
|
|
# would be
|
|
#
|
|
# <html>
|
|
# Content
|
|
# </html>
|
|
#
|
|
# Finally, the block can take block arguments, which can be passed in by +yield+:
|
|
#
|
|
# # The template
|
|
# <%= render :layout => "my_layout" do |customer| %>
|
|
# Hello <%= customer.name %>
|
|
# <% end %>
|
|
#
|
|
# # The layout
|
|
# <html>
|
|
# <%= yield Struct.new(:name).new("David") %>
|
|
# </html>
|
|
#
|
|
# In this case, the layout would receive the block passed into <tt>render :layout</tt>,
|
|
# and the struct specified would be passed into the block as an argument. The result
|
|
# would be
|
|
#
|
|
# <html>
|
|
# Hello David
|
|
# </html>
|
|
#
|
|
def _layout_for(*args, &block) #:nodoc:
|
|
name = args.first
|
|
|
|
if name.is_a?(Symbol)
|
|
@_content_for[name].html_safe
|
|
elsif block
|
|
capture(*args, &block)
|
|
else
|
|
@_content_for[:layout].html_safe
|
|
end
|
|
end
|
|
|
|
# This is the method which actually finds the layout using details in the lookup
|
|
# context object. If no layout is found, it checks if at least a layout with
|
|
# the given name exists across all details before raising the error.
|
|
def find_layout(layout, keys)
|
|
begin
|
|
with_layout_format do
|
|
layout =~ /^\// ?
|
|
with_fallbacks { find_template(layout, nil, false, keys) } : find_template(layout, nil, false, keys)
|
|
end
|
|
rescue ActionView::MissingTemplate => e
|
|
update_details(:formats => nil) do
|
|
raise unless template_exists?(layout)
|
|
end
|
|
end
|
|
end
|
|
|
|
# Contains the logic that actually renders the layout.
|
|
def _render_layout(layout, locals, &block) #:nodoc:
|
|
layout.render(self, locals){ |*name| _layout_for(*name, &block) }
|
|
end
|
|
end
|
|
end
|