raails 5.1中的form_with搜索字段

在Rails 5.1中,所有表单都必须使用form_with完成。 在http://edgeguides.rubyonrails.org/5_1_release_notes.html#unification-of-form-for-and-form-tag-into-form-with中,我只能找到与模型相关的表格示例。

使用form_with在Rails 5.1中完成此Rails 5.0表单的正确方法是什么?

      

这是form_with调用,它完全等同于问题中的form_tag调用:

 <%= form_with url: '/search', method: :get, local: true do |f| %> <%= f.label :q, "Search for:" %> <%= f.text_field :q, id: :q %> <%= f.submit "Search" %> <% end %> 

请注意,默认情况下, form_with通过XHR(也称为remote: true )发送,您必须添加local: true以使其行为类似于form_tag的默认remote: false

在rails指南 , API文档和此github问题讨论中查看更多相关信息。

form_withrails 5.1更新function及其在rails中创建表单的统一方式,它可以用作form_forform_with其中包含某些选项

:url – 表单提交的URL。 类似于传递给url_for或link_to的值。 例如,您可以直接使用命名路由。 当a:scope传递时没有:url,表单只提交到当前URL。

:method – 提交表单时使用的方法,通常是“get”或“post”。 如果使用“patch”,“put”,“delete”或其他动词,则会添加一个名为_method的隐藏输入来模拟post上的动词。

:format – 表单提交的路由格式。 提交到其他资源类型时很有用,例如:json。 如果a:url通过则跳过。

:scope – 为输入字段名称添加前缀的范围,以及提交的参数如何在控制器中分组的范围。

:model – 用于推断:url和:scope by的模型对象,另外填写输入字段值。 因此,如果title属性设置为“Ahoy!”,则标题输入字段的值将为“Ahoy!”。 如果模型是新记录,则生成创建表单,如果现有记录生成更新表单。 通过:scope或:url来覆盖默认值。 例如将params [:post]变成params [:article]。

:authenticity_token – 要在表单中使用的真实性标记。 使用自定义真实性令牌覆盖或传递false以完全跳过真实性令牌字段。 提交到可能限制有效字段的支付网关等外部资源时非常有用。 远程表单可以通过设置config.action_view.embed_authenticity_token_in_remote_forms = false来省略嵌入的真实性令牌。 片段缓存表单时这很有用。 远程表单从元标记中获取真实性标记,因此除非您支持没有JavaScript的浏览器,否则不需要嵌入。

:local – 默认情况下,表单提交是远程和不引人注目的XHR。 使用local:true禁用远程提交。

:skip_enforcing_utf8 – 默认情况下,输出名为utf8的隐藏字段以强制执行UTF-8提交。 设置为true可跳过该字段。

:builder – 覆盖用于构建表单的对象。

:id – 可选的HTML id属性。

:class – 可选的HTML类属性。

:data – 可选的HTML数据属性。

:html – 表单标记的其他可选HTML属性。

 <%= form_with(model: @post, url: super_posts_path) %> <%= form_with(model: @post, scope: :article) %> <%= form_with(model: @post, format: :json) %> <%= form_with(model: @post, authenticity_token: false) %> 

form_with的命名空间路由form_with

对于命名空间路由,例如admin_post_url:

 <%= form_with(model: [ :admin, @post ]) do |form| %> ... <% end %> 

与相关的资源

例如,如果您的资源已定义关联,则您希望在给定路由设置正确的情况下向文档添加注释:

 <%= form_with(model: [ @document, Comment.new ]) do |form| %> ... <% end %> 

了解更多信息结帐文档

您可以像这样使用form_with

 <%= form_with(url: '/search') do |f| %> <%= f.label(:q, "Search for:") %> <%= f.text_field(:q, id: :q) %> <%= f.submit("Search") %> <% end %>