Rails: запутался в синтаксисе передачи локальных переменных в частичные

Короткий ответ: метод рендеринга просматривает первый аргумент, который вы передаете. Если вы передаете хеш (который включает :partial => 'foo', :locals => {blah blah blah}), он передаст все ваши аргументы как хеш и проанализирует их соответствующим образом.

Если вы передаете строку в качестве первого аргумента, он предполагает, что первый аргумент является вашим частичным именем, а остальные будут переданы как ваши локальные имена. Однако в этом последующем вызове он фактически присваивает :locals => your_locals_argument, что в данном случае является всем :locals => {locals hash}, а не только {locals hash}; то есть вы получите :locals => {:locals => {locals hash}}, а не :locals => {locals hash}.

Так что мой совет — всегда явно передавать значения одним и тем же способом, и у вас не будет проблем. Чтобы узнать об этом, я перешел непосредственно к самому коду (actionpack/lib/base.rb, метод render() в Rails 2; Rails 3 отличается). Это хорошее упражнение.

Кроме того, не беспокойтесь о том, чтобы «беспокоить» людей на SO. Вот почему этот сайт существует. Я даже чему-то научился из этого.

если вам нужно указать :locals, вам нужно указать :partial или :template

<%= render :partial => "rabbits/form", :locals => {...} %>

должно сработать

Честно говоря, я знаю только об этих вариантах использования, потому что я следил за Rails последние пару лет и читал объявления о том, что был добавлен новый способ сделать это. Я часто сам в нем ошибаюсь, но обычно это легко исправить.

Если вы спросите меня, это одна из тех частей Rails API, которая не была тщательно продумана. Просто с годами он накапливал все больше и больше синтаксического сахара, не отказываясь от старого поведения. Метод рендеринга имеет диабет.

Что еще хуже, рендеринг ведет себя по-разному в контроллере и представлении. Я также просматриваю содержимое первого аргумента, чтобы увидеть, является ли он файлом, шаблоном, действием или частичным. Если он начинается с косой черты, то это файл или что-то в этом роде.

Я за использование более коротких обозначений, когда это возможно. Потому что короткие обозначения довольно хорошо передают намерение. Когда вы читаете его, он обычно делает то, что вы думаете. Написание частей не так просто.

Вот источник метода рендеринга из http://api.rubyonrails.org/classes/ActionView/Rendering.html#method-i-render:

def render(options = {}, locals = {}, &block)
  case options
  # Here is your last case
  when Hash
    if block_given?
      _render_partial(options.merge(:partial => options.delete(:layout)), &block)
    elsif options.key?(:partial)
      _render_partial(options)
    else
      template = _determine_template(options)
      lookup_context.freeze_formats(template.formats, true)
      _render_template(template, options[:layout], options)
    end
  when :update
    update_page(&block)
  else
    # here the first three cases
    _render_partial(:partial => options, :locals => locals)
  end
end

Надеюсь, это поможет!