控制器中的 render 呼叫有許多選項,但使用 RJS 時大多不必操心。表 3-1 整理了 ActionController 中 render() 的選項,並標示各選項在 RJS 情境下是否適用。
表 3-1 RJS 模板渲染時可用的選項
Rails 也支援在控制器中直接渲染內聯的 RJS 模板,對於那些只需一兩行就能完成的簡單任務特別方便,省去建立整個 .rjs 檔案的麻煩。
內聯 RJS 是透過在控制器的 render() 中傳入 :update 參數來完成。原本寫在 RJS 模板內的內容,改以與 render() 關聯的程式碼區塊來宣告;該區塊會收到一個 JavaScriptGenerator 的實例,用法與一般 RJS 模板相同。以下控制器動作會以 header 局部模板的渲染結果,替換 id 為 header 之 DOM 元素的 innerHTML:
def update
render :update do |page|
page.replace_html 'header', :partial => 'header'
end
end
使用內聯渲染的好處,是不必為了弄清楚動作做了什麼而四處搜尋 .rjs 模板;但缺點是會把視圖程式碼帶進控制器。若內聯的 RJS 超過一兩行,建議還是明確建立獨立的 RJS 模板較佳。
若需要在 Ajax 請求期間重定向瀏覽器,就不能依賴 Rails 標準的 redirect_to()。因為 Prototype 函式庫的反應方式與瀏覽器不同,不會跟隨 3xx 重定向狀態碼。所幸 JavaScriptGenerator 也提供了 redirect_to() 方法,能產生重定向瀏覽器所需的 JavaScript。
這個新的 redirect_to() 在你的 RJS 模板中透過 page 物件呼叫,或在控制器的 update 區塊中呼叫。由於重定向本就更適合放在控制器裡,因此實務上多半會在控制器的內聯 RJS 中呼叫它。用法與你熟悉的標準 redirect_to() 幾乎相同,只是改由 page 物件觸發。以下幾個例子說明了 RJS 重定向的實際運作:
render :update do |page| page.redirect_to :controller => 'employees', :action => 'list' end
這裡將瀏覽器重定向到 EmployeesController 的 list 動作,寫法與平常無異,只是改在 page 物件上呼叫,讓 JavaScriptGenerator 得以產生對應的 JavaScript。當然,這段程式碼必須放在控制器動作中,或放在不含 render :update 區塊的 RJS 模板裡。
若要重定向到絕對網址,只要傳入含 URL 的字串即可:
render :update do |page| page.redirect_to 'https://www.shopify.com' end