Rails: confuso sulla sintassi per il passaggio di locals a partial

Comprendere la "magia" di Rails per quanto riguarda il rendering dei partials (e il passaggio dei locali in essi).

Perché funziona:

<%= render "rabbits/form" %>

E questo lavoro:

<%= render "rabbits/form", :parent => @warren, :flash => flash %>

ma questo non funziona:

<%= render "rabbits/form", :locals => { :parent => @warren, :flash => flash } %>

Ma questo fa:

<%= render :partial =>"rabbits/form", :locals => { :parent => @warren, :flash => flash } %>

Inoltre, come posso cercare queste sfumature in modo da non dover disturbare le persone su SO?

La risposta breve è che il metodo render esamina il primo argomento che passi. Se passi un hash (che include :partial => 'foo', :locals => {blah blah blah}), allora passerà tutti i tuoi argomenti come hash e li analizzerà di conseguenza.

Se passi una stringa come primo argomento, si presume che il primo argomento sia il tuo nome parziale e passerà il resto come le tue variabili locali. Tuttavia, in quella chiamata successiva, assegna effettivamente :locals => your_locals_argument, che in questo caso è l'intero :locals => {locals hash}, invece che solo {locals hash}; cioè si finisce con :locals => {:locals => {locals hash}}, piuttosto che :locals => {locals hash}.

Quindi il mio consiglio è solo di passare sempre esplicitamente i valori allo stesso modo tutto il tempo, e non avrai problemi. Per saperne di più, sono andato direttamente al codice stesso ( actionpack / lib / base.rb , render()metodo in Rails 2; Rails 3 è diverso). È un buon esercizio.

Inoltre, non preoccuparti di "disturbare" le persone su SO. Ecco perché esiste questo sito. Ho anche imparato qualcosa da questo.

se devi specificare: locals, devi specificare: partial o: template

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

dovrebbe funzionare

Per essere onesto, conosco solo questi casi d'uso, perché ho tenuto il passo con Rails negli ultimi due anni e ho letto gli annunci che è stato aggiunto un nuovo modo di farlo. Spesso faccio un errore io stesso, ma di solito è facilmente corretto.

È una di quelle parti dell'API di Rails che non è stata studiata a fondo, se me lo chiedi. Ha semplicemente accumulato sempre più zucchero sintattico nel corso degli anni, senza deprecare nessuno dei vecchi comportamenti. Il metodo di rendering ha il diabete.

A peggiorare le cose, il rendering si comporta in modo diverso nel controller e nella vista. Esamina anche il contenuto del primo argomento per vedere se è un file, un modello, un'azione o una parte. Se inizia con una barra, allora è un file o qualcosa del genere.

Sono favorevole a utilizzare la notazione più breve quando possibile. Perché le annotazioni brevi comunicano abbastanza bene l'intento. Quando lo leggi, di solito fa quello che pensi che faccia. Scrivere i parziali non è semplice.

Ecco la fonte del metodo di rendering da 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

Spero che questo aiuto!