Spec-Zone.ru › Ruby on Rails 7.0

модуль ActionView::Helpers::RenderingHelper

Action View Rendering

Реализует методы, которые позволяют рендерить из контекста представления. Для использования этого модуля, всё что вам нужно — реализовать view_renderer, который возвращает объект ActionView::Renderer.

Публичные методы экземпляра

_layout_for(*args, &block) Показать исходный код
# File actionview/lib/action_view/helpers/rendering_helper.rb, line 98
def _layout_for(*args, &block)
  name = args.first

  if block && !name.is_a?(Symbol)
    capture(*args, &block)
  else
    super
  end
end

Переопределяет _layout_for в объекте контекста, так что он поддерживает случай, когда в частичный передаётся блок. Возвращает содержимое, которое передаётся в макет, заданный по имени или блоком.

Можно представить себе макет как метод, который вызывается с блоком. Если пользователь вызывает yield :some_name, блок по умолчанию возвращает content_for(:some_name). Если пользователь вызывает просто yield, по умолчанию блок возвращает content_for(:layout).

Пользователь может переопределить этот стандартный блок, передав блок в макет:

# The template
<%= render layout: "my_layout" do %>
  Content
<% end %>

# The layout
<html>
  <%= yield %>
</html>

В этом случае, вместо стандартного блока, который бы вернул content_for(:layout), этот метод возвращает блок, переданный в render :layout, и в результате будет

<html>
  Content
</html>

Наконец, блок может принимать аргументы блока, которые могут быть переданы с помощью yield:

# The template
<%= render layout: "my_layout" do |customer| %>
  Hello <%= customer.name %>
<% end %>

# The layout
<html>
  <%= yield Struct.new(:name).new("David") %>
</html>

В этом случае макет получит блок, переданный в render :layout, а указанная структура будет передана в блок в качестве аргумента. Результатом будет

<html>
  Hello David
</html>
Вызывает метод суперкласса
render(options = {}, locals = {}, &block) Показать исходный код
# File actionview/lib/action_view/helpers/rendering_helper.rb, line 31
def render(options = {}, locals = {}, &block)
  case options
  when Hash
    in_rendering_context(options) do |renderer|
      if block_given?
        view_renderer.render_partial(self, options.merge(partial: options[:layout]), &block)
      else
        view_renderer.render(self, options)
      end
    end
  else
    if options.respond_to?(:render_in)
      options.render_in(self, &block)
    else
      view_renderer.render_partial(self, partial: options, locals: locals, &block)
    end
  end
end

Возвращает результат рендера, определяемый хэшем опций. Основные опции:

  • :partial - См. ActionView::PartialRenderer.

  • :file - Рендерит явную страницу шаблона (раньше это был стандартный вариант), добавьте :locals для передачи параметров.

  • :inline - Рендерит встроенный шаблон, аналогично тому, как это делается в контроллере.

  • :plain - Рендерит переданный текст. Устанавливает тип содержимого как text/plain.

  • :html - Рендерит переданную безопасную строку HTML, в противном случае выполняет HTML-экранирование строки сначала. Устанавливает тип содержимого как text/html.

  • :body - Рендерит переданный текст, наследуя тип содержимого text/plain из объекта ActionDispatch::Response.

Если хэш options не передан или если указан :update, то:

Если передан объект, отвечающий за render_in, то вызывается render_in на объекте, передавая текущий контекст представления.

В противном случае частичная страница рендерится с использованием второго параметра в качестве хэша локалей.

© 2004–2021 David Heinemeier Hansson
Licensed under the MIT License.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API