form_remote_tag() 與 link_to_remote() 十分相似,差別在於它會連同整個 HTML 表單的內容一起送出。這意味著後端的 action 可以使用使用者輸入的資料來決定回應內容。
下面的例子由一個清單與一個 Ajax 表單組成,使用者可以在不刷新頁面的情況下往清單裡追加項目。
視圖模板 index.rhtml 大致如下:
<html>
<head>
<title>Ajax List Demo</title>
<%= javascript_include_tag "prototype" %>
</head>
<body>
<h3>Add to list using Ajax</h3>
<%= form_remote_tag(:update => "my_list",
:url => { :action => :add_item },
:position => "top" ) %>
New item text:
<%= text_field_tag :newitem %>
<%= submit_tag "Add item with Ajax" %>
<%= end_form_tag %>
<ul id="my_list">
<li>Original item... please add more!</li>
</ul>
</body>
</html>
關鍵在表單的起訖兩行:因為它們用的是 form_remote_tag() 而非 form_tag(),Rails 便會改用 XMLHttpRequest 來提交這份表單。參數的意義如下:
class ListdemoController < ApplicationController
def index
end
def add_item
render_text "<li>" + params[:newitem] + "</li>"
end
end
add_item 這個 action 很單純:把表單中 newitem 欄位收到的文字包成一個 <li> 片段回傳,客戶端再把它插到清單最前面。這正是 Rails Ajax 模型的典型縮影——伺服器只負責產生一小塊 HTML,剩下的交給客戶端腳本完成。
不過要留意,直接把 params[:newitem] 的字串插值進 HTML,等於把 XSS 的門敞開;實務上應走 h() 一類的轉義,或由前端負責清理。