kotovalexarian-likes-github/rails--rails
1
0
Fork 0
mirror of https://github.com/rails/rails.git synced 2022-11-09 12:12:34 -05:00
Code Releases Activity

Update form_with and form_for documentation to reflect new non-remote defaults in 6.1

Browse source
This commit is contained in:
Kyle Keesling 2020-12-29 07:28:13 -05:00
parent fc73becc3c
commit 3aef59cae2
No known key found for this signature in database
GPG key ID: 3D0687B4CB8EBDE5
1 changed files with 7 additions and 13 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

20
actionview/lib/action_view/helpers/form_helper.rb
View file

@ -186,8 +186,7 @@ module ActionView
# get the authenticity token from the <tt>meta</tt> tag, so embedding is
# unnecessary unless you support browsers without JavaScript.
# * <tt>:remote</tt> - If set to true, will allow the Unobtrusive
# JavaScript drivers to control the submit behavior. By default this
# behavior is an ajax submit.
# JavaScript drivers to control the submit behavior.
# * <tt>:enforce_utf8</tt> - If set to false, a hidden input with name
# utf8 is not output.
# * <tt>:html</tt> - Optional HTML attributes for the form tag.
@ -323,10 +322,8 @@ module ActionView
# remote: true
#
# in the options hash creates a form that will allow the unobtrusive JavaScript drivers to modify its
# behavior. The expected default behavior is an XMLHttpRequest in the background instead of the regular
# POST arrangement, but ultimately the behavior is the choice of the JavaScript driver implementor.
# Even though it's using JavaScript to serialize the form elements, the form submission will work just like
# a regular submission as viewed by the receiving side (all elements available in <tt>params</tt>).
# behavior. The form submission will work just like a regular submission as viewed by the receiving
# side (all elements available in <tt>params</tt>).
#
# Example:
#
@ -536,11 +533,6 @@ module ActionView
# accessible as <tt>params[:title]</tt> and <tt>params[:post][:title]</tt>
# respectively.
#
# By default +form_with+ attaches the <tt>data-remote</tt> attribute
# submitting the form via an XMLHTTPRequest in the background if an
# Unobtrusive JavaScript driver, like rails-ujs, is used. See the
# <tt>:local</tt> option for more.
#
# For ease of comparison the examples above left out the submit button,
# as well as the auto generated hidden fields that enable UTF-8 support
# and adds an authenticity token needed for cross site request forgery
@ -612,8 +604,10 @@ module ActionView
# This is helpful when fragment-caching the form. Remote forms
# get the authenticity token from the <tt>meta</tt> tag, so embedding is
# unnecessary unless you support browsers without JavaScript.
# * <tt>:local</tt> - By default form submits are remote and unobtrusive XHRs.
# Disable remote submits with <tt>local: true</tt>.
# * <tt>:local</tt> - By default form submits via typical HTTP requests.
# Enable remote and unobtrusive XHRs submits with <tt>local: false</tt>.
# Remote forms may be enabled by default by setting
# <tt>config.action_view.form_with_generates_remote_forms = true</tt>.
# * <tt>:skip_enforcing_utf8</tt> - If set to true, a hidden input with name
# utf8 is not output.
# * <tt>:builder</tt> - Override the object used to build the form.