actionview 7.0.8.4 → 7.1.0.beta1

Sign up to get free protection for your applications and to get access to all the features.
Files changed (90) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG.md +235 -377
  3. data/MIT-LICENSE +1 -1
  4. data/README.rdoc +1 -1
  5. data/app/assets/javascripts/rails-ujs.esm.js +668 -0
  6. data/app/assets/javascripts/rails-ujs.js +606 -0
  7. data/lib/action_view/base.rb +28 -7
  8. data/lib/action_view/buffers.rb +106 -8
  9. data/lib/action_view/cache_expiry.rb +40 -43
  10. data/lib/action_view/context.rb +1 -1
  11. data/lib/action_view/deprecator.rb +7 -0
  12. data/lib/action_view/digestor.rb +1 -1
  13. data/lib/action_view/gem_version.rb +4 -4
  14. data/lib/action_view/helpers/active_model_helper.rb +1 -1
  15. data/lib/action_view/helpers/asset_tag_helper.rb +130 -46
  16. data/lib/action_view/helpers/asset_url_helper.rb +6 -5
  17. data/lib/action_view/helpers/atom_feed_helper.rb +5 -5
  18. data/lib/action_view/helpers/cache_helper.rb +3 -9
  19. data/lib/action_view/helpers/capture_helper.rb +24 -10
  20. data/lib/action_view/helpers/content_exfiltration_prevention_helper.rb +70 -0
  21. data/lib/action_view/helpers/controller_helper.rb +6 -0
  22. data/lib/action_view/helpers/csp_helper.rb +2 -2
  23. data/lib/action_view/helpers/csrf_helper.rb +2 -2
  24. data/lib/action_view/helpers/date_helper.rb +17 -19
  25. data/lib/action_view/helpers/debug_helper.rb +3 -3
  26. data/lib/action_view/helpers/form_helper.rb +43 -18
  27. data/lib/action_view/helpers/form_options_helper.rb +2 -1
  28. data/lib/action_view/helpers/form_tag_helper.rb +43 -9
  29. data/lib/action_view/helpers/javascript_helper.rb +1 -0
  30. data/lib/action_view/helpers/number_helper.rb +2 -1
  31. data/lib/action_view/helpers/output_safety_helper.rb +2 -2
  32. data/lib/action_view/helpers/rendering_helper.rb +1 -1
  33. data/lib/action_view/helpers/sanitize_helper.rb +33 -14
  34. data/lib/action_view/helpers/tag_helper.rb +5 -27
  35. data/lib/action_view/helpers/tags/base.rb +11 -52
  36. data/lib/action_view/helpers/tags/collection_check_boxes.rb +1 -0
  37. data/lib/action_view/helpers/tags/collection_radio_buttons.rb +1 -0
  38. data/lib/action_view/helpers/tags/collection_select.rb +3 -0
  39. data/lib/action_view/helpers/tags/date_field.rb +1 -1
  40. data/lib/action_view/helpers/tags/date_select.rb +2 -0
  41. data/lib/action_view/helpers/tags/datetime_field.rb +14 -6
  42. data/lib/action_view/helpers/tags/datetime_local_field.rb +11 -2
  43. data/lib/action_view/helpers/tags/grouped_collection_select.rb +3 -0
  44. data/lib/action_view/helpers/tags/month_field.rb +1 -1
  45. data/lib/action_view/helpers/tags/select.rb +3 -0
  46. data/lib/action_view/helpers/tags/select_renderer.rb +56 -0
  47. data/lib/action_view/helpers/tags/time_field.rb +1 -1
  48. data/lib/action_view/helpers/tags/time_zone_select.rb +3 -0
  49. data/lib/action_view/helpers/tags/week_field.rb +1 -1
  50. data/lib/action_view/helpers/tags/weekday_select.rb +3 -0
  51. data/lib/action_view/helpers/tags.rb +2 -0
  52. data/lib/action_view/helpers/text_helper.rb +32 -16
  53. data/lib/action_view/helpers/translation_helper.rb +3 -3
  54. data/lib/action_view/helpers/url_helper.rb +41 -14
  55. data/lib/action_view/helpers.rb +2 -0
  56. data/lib/action_view/layouts.rb +4 -2
  57. data/lib/action_view/log_subscriber.rb +49 -32
  58. data/lib/action_view/lookup_context.rb +29 -13
  59. data/lib/action_view/path_registry.rb +57 -0
  60. data/lib/action_view/path_set.rb +13 -14
  61. data/lib/action_view/railtie.rb +26 -3
  62. data/lib/action_view/record_identifier.rb +15 -8
  63. data/lib/action_view/renderer/abstract_renderer.rb +1 -1
  64. data/lib/action_view/renderer/collection_renderer.rb +9 -1
  65. data/lib/action_view/renderer/partial_renderer/collection_caching.rb +2 -1
  66. data/lib/action_view/renderer/partial_renderer.rb +2 -1
  67. data/lib/action_view/renderer/renderer.rb +2 -0
  68. data/lib/action_view/renderer/streaming_template_renderer.rb +3 -2
  69. data/lib/action_view/renderer/template_renderer.rb +3 -2
  70. data/lib/action_view/rendering.rb +22 -4
  71. data/lib/action_view/ripper_ast_parser.rb +5 -5
  72. data/lib/action_view/template/error.rb +14 -1
  73. data/lib/action_view/template/handlers/builder.rb +4 -4
  74. data/lib/action_view/template/handlers/erb/erubi.rb +23 -27
  75. data/lib/action_view/template/handlers/erb.rb +73 -1
  76. data/lib/action_view/template/handlers.rb +1 -1
  77. data/lib/action_view/template/html.rb +1 -1
  78. data/lib/action_view/template/raw_file.rb +1 -1
  79. data/lib/action_view/template/renderable.rb +1 -1
  80. data/lib/action_view/template/resolver.rb +10 -2
  81. data/lib/action_view/template/text.rb +1 -1
  82. data/lib/action_view/template/types.rb +25 -34
  83. data/lib/action_view/template.rb +179 -52
  84. data/lib/action_view/template_path.rb +2 -0
  85. data/lib/action_view/test_case.rb +8 -5
  86. data/lib/action_view/unbound_template.rb +15 -5
  87. data/lib/action_view/version.rb +1 -1
  88. data/lib/action_view/view_paths.rb +15 -24
  89. data/lib/action_view.rb +4 -1
  90. metadata +26 -26
data/CHANGELOG.md CHANGED
@@ -1,54 +1,25 @@
1
- ## Rails 7.0.8.4 (June 04, 2024) ##
1
+ ## Rails 7.1.0.beta1 (September 13, 2023) ##
2
2
 
3
- * No changes.
3
+ * Fix `simple_format` with blank `wrapper_tag` option returns plain html tag
4
4
 
5
+ By default `simple_format` method returns the text wrapped with `<p>`. But if we explicitly specify
6
+ the `wrapper_tag: nil` in the options, it returns the text wrapped with `<></>` tag.
5
7
 
6
- ## Rails 7.0.8.3 (May 17, 2024) ##
7
-
8
- * No changes.
9
-
10
-
11
- ## Rails 7.0.8.2 (May 16, 2024) ##
12
-
13
- * No changes.
14
-
15
-
16
- ## Rails 7.0.8.1 (February 21, 2024) ##
17
-
18
- * No changes.
19
-
20
-
21
- ## Rails 7.0.8 (September 09, 2023) ##
22
-
23
- * Fix `form_for` missing the hidden `_method` input for models with a
24
- namespaced route.
25
-
26
- *Hartley McGuire*
27
-
28
- * Fix `render collection: @records, cache: true` inside `jbuilder` templates
29
-
30
- The previous fix that shipped in `7.0.7` assumed template fragments are always strings,
31
- this isn't true with `jbuilder`.
32
-
33
- *Jean Boussier*
34
-
35
- ## Rails 7.0.7.2 (August 22, 2023) ##
36
-
37
- * No changes.
38
-
39
-
40
- ## Rails 7.0.7.1 (August 22, 2023) ##
41
-
42
- * No changes.
43
-
8
+ Before:
44
9
 
45
- ## Rails 7.0.7 (August 09, 2023) ##
10
+ ```ruby
11
+ simple_format("Hello World", {}, { wrapper_tag: nil })
12
+ # <>Hello World</>
13
+ ```
46
14
 
47
- * Fix `render collection: @records, cache: true` to cache fragments as bare strings
15
+ After:
48
16
 
49
- Previously it would incorrectly cache them as Action View buffers.
17
+ ```ruby
18
+ simple_format("Hello World", {}, { wrapper_tag: nil })
19
+ # <p>Hello World</p>
20
+ ```
50
21
 
51
- *Jean Boussier*
22
+ *Akhil G Krishnan*, *Junichi Ito*
52
23
 
53
24
  * Don't double-encode nested `field_id` and `field_name` index values
54
25
 
@@ -57,457 +28,344 @@
57
28
 
58
29
  *Sean Doyle*
59
30
 
31
+ * Allow opting in/out of `Link preload` headers when calling `stylesheet_link_tag` or `javascript_include_tag`
60
32
 
61
- ## Rails 7.0.6 (June 29, 2023) ##
62
-
63
- * No changes.
64
-
65
-
66
- ## Rails 7.0.5.1 (June 26, 2023) ##
67
-
68
- * No changes.
33
+ ```ruby
34
+ # will exclude header, even if setting is enabled:
35
+ javascript_include_tag("http://example.com/all.js", preload_links_header: false)
69
36
 
37
+ # will include header, even if setting is disabled:
38
+ stylesheet_link_tag("http://example.com/all.js", preload_links_header: true)
39
+ ```
70
40
 
71
- ## Rails 7.0.5 (May 24, 2023) ##
41
+ *Alex Ghiculescu*
72
42
 
73
- * `FormBuilder#id` finds id set by `form_for` and `form_with`.
43
+ * Stop generating `Link preload` headers once it has reached 1KB.
74
44
 
75
- *Matt Polito*
45
+ Some proxies have trouble handling large headers, but more importantly preload links
46
+ have diminishing returns so it's preferable not to go overboard with them.
76
47
 
77
- * Allow all available locales for template lookups.
48
+ If tighter control is needed, it's recommended to disable automatic generation of preloads
49
+ and to generate them manually from the controller or from a middleware.
78
50
 
79
- *Ben Dilley*
51
+ *Jean Boussier*
80
52
 
81
- * Choices of `select` can optionally contain html attributes as the last element
82
- of the child arrays when using grouped/nested collections
53
+ * `simple_format` helper now handles a `:sanitize_options` - any extra options you want appending to the sanitize.
83
54
 
84
- ```erb
85
- <%= form.select :foo, [["North America", [["United States","US"],["Canada","CA"]], { disabled: "disabled" }]] %>
86
- # => <select><optgroup label="North America" disabled="disabled"><option value="US">United States</option><option value="CA">Canada</option></optgroup></select>
55
+ Before:
56
+ ```ruby
57
+ simple_format("<a target=\"_blank\" href=\"http://example.com\">Continue</a>")
58
+ # => "<p><a href=\"http://example.com\">Continue</a></p>"
87
59
  ```
88
60
 
89
- *Chris Gunther*
90
-
91
-
92
- ## Rails 7.0.4.3 (March 13, 2023) ##
61
+ After:
62
+ ```ruby
63
+ simple_format("<a target=\"_blank\" href=\"http://example.com\">Continue</a>", {}, { sanitize_options: { attributes: %w[target href] } })
64
+ # => "<p><a target=\"_blank\" href=\"http://example.com\">Continue</a></p>"
65
+ ```
93
66
 
94
- * Ignore certain data-* attributes in rails-ujs when element is contenteditable
67
+ *Andrei Andriichuk*
95
68
 
96
- [CVE-2023-23913]
69
+ * Add support for HTML5 standards-compliant sanitizers, and default to `Rails::HTML5::Sanitizer`
70
+ in the Rails 7.1 configuration if it is supported.
97
71
 
72
+ Action View's HTML sanitizers can be configured by setting
73
+ `config.action_view.sanitizer_vendor`. Supported values are `Rails::HTML4::Sanitizer` or
74
+ `Rails::HTML5::Sanitizer`.
98
75
 
99
- ## Rails 7.0.4.2 (January 24, 2023) ##
76
+ The Rails 7.1 configuration will set this to `Rails::HTML5::Sanitizer` when it is supported, and
77
+ fall back to `Rails::HTML4::Sanitizer`. Previous configurations default to
78
+ `Rails::HTML4::Sanitizer`.
100
79
 
101
- * No changes.
80
+ *Mike Dalessio*
102
81
 
82
+ * `config.dom_testing_default_html_version` controls the HTML parser used by
83
+ `ActionView::TestCase#document_root_element`, which creates the DOM used by the assertions in
84
+ Rails::Dom::Testing.
103
85
 
104
- ## Rails 7.0.4.1 (January 17, 2023) ##
86
+ The Rails 7.1 default configuration opts into the HTML5 parser when it is supported, to better
87
+ represent what the DOM would be in a browser user agent. Previously this test helper always used
88
+ Nokogiri's HTML4 parser.
105
89
 
106
- * No changes.
90
+ *Mike Dalessio*
107
91
 
92
+ * Add support for the HTML picture tag. It supports passing a String, an Array or a Block.
93
+ Supports passing properties directly to the img tag via the `:image` key.
94
+ Since the picture tag requires an img tag, the last element you provide will be used for the img tag.
95
+ For complete control over the picture tag, a block can be passed, which will populate the contents of the tag accordingly.
108
96
 
109
- ## Rails 7.0.4 (September 09, 2022) ##
97
+ Can be used like this for a single source:
98
+ ```erb
99
+ <%= picture_tag("picture.webp") %>
100
+ ```
101
+ which will generate the following:
102
+ ```html
103
+ <picture>
104
+ <img src="/images/picture.webp" />
105
+ </picture>
106
+ ```
110
107
 
111
- * Guard against `ActionView::Helpers::FormTagHelper#field_name` calls with nil
112
- `object_name` arguments. For example:
108
+ For multiple sources:
109
+ ```erb
110
+ <%= picture_tag("picture.webp", "picture.png", :class => "mt-2", :image => { alt: "Image", class: "responsive-img" }) %>
111
+ ```
112
+ will generate:
113
+ ```html
114
+ <picture class="mt-2">
115
+ <source srcset="/images/picture.webp" />
116
+ <source srcset="/images/picture.png" />
117
+ <img alt="Image" class="responsive-img" src="/images/picture.png" />
118
+ </picture>
119
+ ```
113
120
 
121
+ Full control via a block:
114
122
  ```erb
115
- <%= fields do |f| %>
116
- <%= f.field_name :body %>
123
+ <%= picture_tag(:class => "my-class") do %>
124
+ <%= tag(:source, :srcset => image_path("picture.webp")) %>
125
+ <%= tag(:source, :srcset => image_path("picture.png")) %>
126
+ <%= image_tag("picture.png", :alt => "Image") %>
117
127
  <% end %>
118
128
  ```
129
+ will generate:
130
+ ```html
131
+ <picture class="my-class">
132
+ <source srcset="/images/picture.webp" />
133
+ <source srcset="/images/picture.png" />
134
+ <img alt="Image" src="/images/picture.png" />
135
+ </picture>
136
+ ```
119
137
 
120
- *Sean Doyle*
121
-
122
- * Strings returned from `strip_tags` are correctly tagged `html_safe?`
123
-
124
- Because these strings contain no HTML elements and the basic entities are escaped, they are safe
125
- to be included as-is as PCDATA in HTML content. Tagging them as html-safe avoids double-escaping
126
- entities when being concatenated to a SafeBuffer during rendering.
127
-
128
- Fixes [rails/rails-html-sanitizer#124](https://github.com/rails/rails-html-sanitizer/issues/124)
129
-
130
- *Mike Dalessio*
138
+ *Juan Pablo Balarini*
131
139
 
132
- ## Rails 7.0.3.1 (July 12, 2022) ##
140
+ * Remove deprecated support to passing instance variables as locals to partials.
133
141
 
134
- * No changes.
142
+ *Rafael Mendonça França*
135
143
 
144
+ * Remove deprecated constant `ActionView::Path`.
136
145
 
137
- ## Rails 7.0.3 (May 09, 2022) ##
146
+ *Rafael Mendonça França*
138
147
 
139
- * Ensure models passed to `form_for` attempt to call `to_model`.
148
+ * Guard `token_list` calls from escaping HTML too often
140
149
 
141
150
  *Sean Doyle*
142
151
 
143
- ## Rails 7.0.2.4 (April 26, 2022) ##
144
-
145
- * Fix and add protections for XSS in `ActionView::Helpers` and `ERB::Util`.
146
-
147
- Escape dangerous characters in names of tags and names of attributes in the
148
- tag helpers, following the XML specification. Rename the option
149
- `:escape_attributes` to `:escape`, to simplify by applying the option to the
150
- whole tag.
151
-
152
- *Álvaro Martín Fraguas*
153
-
154
- ## Rails 7.0.2.3 (March 08, 2022) ##
152
+ * `select` can now be called with a single hash containing options and some HTML options
155
153
 
156
- * No changes.
154
+ Previously this would not work as expected:
157
155
 
156
+ ```erb
157
+ <%= select :post, :author, authors, required: true %>
158
+ ```
158
159
 
159
- ## Rails 7.0.2.2 (February 11, 2022) ##
160
-
161
- * No changes.
162
-
163
-
164
- ## Rails 7.0.2.1 (February 11, 2022) ##
165
-
166
- * No changes.
167
-
168
-
169
- ## Rails 7.0.2 (February 08, 2022) ##
170
-
171
- * Ensure `preload_link_tag` preloads JavaScript modules correctly.
172
-
173
- *Máximo Mussini*
174
-
175
- * Fix `stylesheet_link_tag` and similar helpers are being used to work in objects with
176
- a `response` method.
177
-
178
- *dark-panda*
179
-
180
-
181
- ## Rails 7.0.1 (January 06, 2022) ##
182
-
183
- * Fix `button_to` to work with a hash parameter as URL.
160
+ Instead you needed to do this:
184
161
 
185
- *MingyuanQin*
162
+ ```erb
163
+ <%= select :post, :author, authors, {}, required: true %>
164
+ ```
186
165
 
187
- * Fix `link_to` with a model passed as an argument twice.
166
+ Now, either form is accepted, for the following HTML attributes: `required`, `multiple`, `size`.
188
167
 
189
168
  *Alex Ghiculescu*
190
169
 
170
+ * Datetime form helpers (`time_field`, `date_field`, `datetime_field`, `week_field`, `month_field`) now accept an instance of Time/Date/DateTime as `:value` option.
191
171
 
192
- ## Rails 7.0.0 (December 15, 2021) ##
193
-
194
- * Support `include_hidden:` option in calls to
195
- `ActionView::Helper::FormBuilder#file_field` with `multiple: true` to
196
- support submitting an empty collection of files.
197
-
198
- ```ruby
199
- form.file_field :attachments, multiple: true
200
- # => <input type="hidden" autocomplete="off" name="post[attachments][]" value="">
201
- <input type="file" multiple="multiple" id="post_attachments" name="post[attachments][]">
202
-
203
- form.file_field :attachments, multiple: true, include_hidden: false
204
- # => <input type="file" multiple="multiple" id="post_attachments" name="post[attachments][]">
172
+ Before:
173
+ ```erb
174
+ <%= form.datetime_field :written_at, value: Time.current.strftime("%Y-%m-%dT%T") %>
205
175
  ```
206
176
 
207
- *Sean Doyle*
208
-
209
- * Fix `number_with_precision(raise: true)` always raising even on valid numbers.
210
-
211
- *Pedro Moreira*
177
+ After:
178
+ ```erb
179
+ <%= form.datetime_field :written_at, value: Time.current %>
180
+ ```
212
181
 
182
+ *Andrey Samsonov*
213
183
 
214
- ## Rails 7.0.0.rc3 (December 14, 2021) ##
184
+ * Choices of `select` can optionally contain html attributes as the last element
185
+ of the child arrays when using grouped/nested collections
215
186
 
216
- * No changes.
187
+ ```erb
188
+ <%= form.select :foo, [["North America", [["United States","US"],["Canada","CA"]], { disabled: "disabled" }]] %>
189
+ # => <select><optgroup label="North America" disabled="disabled"><option value="US">United States</option><option value="CA">Canada</option></optgroup></select>
190
+ ```
217
191
 
192
+ *Chris Gunther*
218
193
 
219
- ## Rails 7.0.0.rc2 (December 14, 2021) ##
194
+ * `check_box_tag` and `radio_button_tag` now accept `checked` as a keyword argument
220
195
 
221
- * No changes.
196
+ This is to make the API more consistent with the `FormHelper` variants. You can now
197
+ provide `checked` as a positional or keyword argument:
222
198
 
223
- ## Rails 7.0.0.rc1 (December 06, 2021) ##
199
+ ```erb
200
+ = check_box_tag "admin", "1", false
201
+ = check_box_tag "admin", "1", checked: false
224
202
 
225
- * Support `fields model: [@nested, @model]` the same way as `form_with model:
226
- [@nested, @model]`.
203
+ = radio_button_tag 'favorite_color', 'maroon', false
204
+ = radio_button_tag 'favorite_color', 'maroon', checked: false
205
+ ```
227
206
 
228
- *Sean Doyle*
207
+ *Alex Ghiculescu*
229
208
 
230
- * Infer HTTP verb `[method]` from a model or Array with model as the first
231
- argument to `button_to` when combined with a block:
209
+ * Allow passing a class to `dom_id`.
210
+ You no longer need to call `new` when passing a class to `dom_id`.
211
+ This makes `dom_id` behave like `dom_class` in this regard.
212
+ Apart from saving a few keystrokes, it prevents Ruby from needing
213
+ to instantiate a whole new object just to generate a string.
232
214
 
215
+ Before:
233
216
  ```ruby
234
- button_to(Workshop.find(1)){ "Update" }
235
- #=> <form method="post" action="/workshops/1" class="button_to">
236
- #=> <input type="hidden" name="_method" value="patch" autocomplete="off" />
237
- #=> <button type="submit">Update</button>
238
- #=> </form>
239
-
240
- button_to([ Workshop.find(1), Session.find(1) ]) { "Update" }
241
- #=> <form method="post" action="/workshops/1/sessions/1" class="button_to">
242
- #=> <input type="hidden" name="_method" value="patch" autocomplete="off" />
243
- #=> <button type="submit">Update</button>
244
- #=> </form>
217
+ dom_id(Post) # => NoMethodError: undefined method `to_key' for Post:Class
245
218
  ```
246
219
 
247
- *Sean Doyle*
248
-
249
- * Support passing a Symbol as the first argument to `FormBuilder#button`:
250
-
220
+ After:
251
221
  ```ruby
252
- form.button(:draft, value: true)
253
- # => <button name="post[draft]" value="true" type="submit">Create post</button>
254
-
255
- form.button(:draft, value: true) do
256
- content_tag(:strong, "Save as draft")
257
- end
258
- # => <button name="post[draft]" value="true" type="submit">
259
- # <strong>Save as draft</strong>
260
- # </button>
222
+ dom_id(Post) # => "new_post"
261
223
  ```
262
224
 
263
- *Sean Doyle*
225
+ *Goulven Champenois*
264
226
 
265
- * Introduce the `field_name` view helper, along with the
266
- `FormBuilder#field_name` counterpart:
227
+ * Report `:locals` as part of the data returned by ActionView render instrumentation.
267
228
 
229
+ Before:
268
230
  ```ruby
269
- form_for @post do |f|
270
- f.field_tag :tag, name: f.field_name(:tag, multiple: true)
271
- # => <input type="text" name="post[tag][]">
272
- end
231
+ {
232
+ identifier: "/Users/adam/projects/notifications/app/views/posts/index.html.erb",
233
+ layout: "layouts/application"
234
+ }
273
235
  ```
274
236
 
275
- *Sean Doyle*
276
-
277
- * Execute the `ActionView::Base.field_error_proc` within the context of the
278
- `ActionView::Base` instance:
279
-
237
+ After:
280
238
  ```ruby
281
- config.action_view.field_error_proc = proc { |html| content_tag(:div, html, class: "field_with_errors") }
239
+ {
240
+ identifier: "/Users/adam/projects/notifications/app/views/posts/index.html.erb",
241
+ layout: "layouts/application",
242
+ locals: {foo: "bar"}
243
+ }
282
244
  ```
283
245
 
284
- *Sean Doyle*
246
+ *Aaron Gough*
285
247
 
286
- * Add support for `button_to ..., authenticity_token: false`
248
+ * Strip `break_sequence` at the end of `word_wrap`.
287
249
 
288
- ```ruby
289
- button_to "Create", Post.new, authenticity_token: false
290
- # => <form class="button_to" method="post" action="/posts"><button type="submit">Create</button></form>
250
+ This fixes a bug where `word_wrap` didn't properly strip off break sequences that had printable characters.
291
251
 
292
- button_to "Create", Post.new, authenticity_token: true
293
- # => <form class="button_to" method="post" action="/posts"><button type="submit">Create</button><input type="hidden" name="form_token" value="abc123..." autocomplete="off" /></form>
252
+ For example, compare the outputs of this template:
294
253
 
295
- button_to "Create", Post.new, authenticity_token: "secret"
296
- # => <form class="button_to" method="post" action="/posts"><button type="submit">Create</button><input type="hidden" name="form_token" value="secret" autocomplete="off" /></form>
254
+ ```erb
255
+ # <%= word_wrap("11 22\n33 44", line_width: 2, break_sequence: "\n# ") %>
297
256
  ```
298
257
 
299
- *Sean Doyle*
300
-
301
- * Support rendering `<form>` elements _without_ `[action]` attributes by:
258
+ Before:
302
259
 
303
- * `form_with url: false` or `form_with ..., html: { action: false }`
304
- * `form_for ..., url: false` or `form_for ..., html: { action: false }`
305
- * `form_tag false` or `form_tag ..., action: false`
306
- * `button_to "...", false` or `button_to(false) { ... }`
260
+ ```
261
+ # 11
262
+ # 22
263
+ #
264
+ # 33
265
+ # 44
266
+ #
267
+ ```
307
268
 
308
- *Sean Doyle*
269
+ After:
309
270
 
310
- * Add `:day_format` option to `date_select`
271
+ ```
272
+ # 11
273
+ # 22
274
+ # 33
275
+ # 44
276
+ ```
311
277
 
312
- date_select("article", "written_on", day_format: ->(day) { day.ordinalize })
313
- # generates day options like <option value="1">1st</option>\n<option value="2">2nd</option>...
278
+ *Max Chernyak*
314
279
 
315
- *Shunichi Ikegami*
280
+ * Allow templates to set strict `locals`.
316
281
 
317
- * Allow `link_to` helper to infer link name from `Model#to_s` when it
318
- is used with a single argument:
282
+ By default, templates will accept any `locals` as keyword arguments. To define what `locals` a template accepts, add a `locals` magic comment:
319
283
 
320
- link_to @profile
321
- #=> <a href="/profiles/1">Eileen</a>
284
+ ```erb
285
+ <%# locals: (message:) -%>
286
+ <%= message %>
287
+ ```
322
288
 
323
- This assumes the model class implements a `to_s` method like this:
289
+ Default values can also be provided:
324
290
 
325
- class Profile < ApplicationRecord
326
- # ...
327
- def to_s
328
- name
329
- end
330
- end
291
+ ```erb
292
+ <%# locals: (message: "Hello, world!") -%>
293
+ <%= message %>
294
+ ```
331
295
 
332
- Previously you had to supply a second argument even if the `Profile`
333
- model implemented a `#to_s` method that called the `name` method.
296
+ Or `locals` can be disabled entirely:
334
297
 
335
- link_to @profile, @profile.name
336
- #=> <a href="/profiles/1">Eileen</a>
298
+ ```erb
299
+ <%# locals: () %>
300
+ ```
337
301
 
338
- *Olivier Lacan*
302
+ *Joel Hawksley*
339
303
 
340
- * Support svg unpaired tags for `tag` helper.
304
+ * Add `include_seconds` option for `datetime_local_field`
341
305
 
342
- tag.svg { tag.use('href' => "#cool-icon") }
343
- # => <svg><use href="#cool-icon"></svg>
306
+ This allows to omit seconds part in the input field, by passing `include_seconds: false`
344
307
 
345
- *Oleksii Vasyliev*
308
+ *Wojciech Wnętrzak*
346
309
 
310
+ * Guard against `ActionView::Helpers::FormTagHelper#field_name` calls with nil
311
+ `object_name` arguments. For example:
347
312
 
348
- ## Rails 7.0.0.alpha2 (September 15, 2021) ##
313
+ ```erb
314
+ <%= fields do |f| %>
315
+ <%= f.field_name :body %>
316
+ <% end %>
317
+ ```
349
318
 
350
- * No changes.
319
+ *Sean Doyle*
351
320
 
321
+ * Strings returned from `strip_tags` are correctly tagged `html_safe?`
352
322
 
353
- ## Rails 7.0.0.alpha1 (September 15, 2021) ##
323
+ Because these strings contain no HTML elements and the basic entities are escaped, they are safe
324
+ to be included as-is as PCDATA in HTML content. Tagging them as html-safe avoids double-escaping
325
+ entities when being concatenated to a SafeBuffer during rendering.
354
326
 
355
- * Improves the performance of ActionView::Helpers::NumberHelper formatters by avoiding the use of
356
- exceptions as flow control.
327
+ Fixes [rails/rails-html-sanitizer#124](https://github.com/rails/rails-html-sanitizer/issues/124)
357
328
 
358
329
  *Mike Dalessio*
359
330
 
360
- * `preload_link_tag` properly inserts `as` attributes for files with `image` MIME types, such as JPG or SVG.
361
-
362
- *Nate Berkopec*
363
-
364
- * Add `weekday_options_for_select` and `weekday_select` helper methods. Also adds `weekday_select` to `FormBuilder`.
365
-
366
- *Drew Bragg*, *Dana Kashubeck*, *Kasper Timm Hansen*
367
-
368
- * Add `caching?` helper that returns whether the current code path is being cached and `uncacheable!` to denote helper methods that can't participate in fragment caching.
369
-
370
- *Ben Toews*, *John Hawthorn*, *Kasper Timm Hansen*, *Joel Hawksley*
371
-
372
- * Add `include_seconds` option for `time_field`.
373
-
374
- <%= form.time_field :foo, include_seconds: false %>
375
- # => <input value="16:22" type="time" />
376
-
377
- Default includes seconds:
378
-
379
- <%= form.time_field :foo %>
380
- # => <input value="16:22:01.440" type="time" />
381
-
382
- This allows you to take advantage of [different rendering options](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input/time#time_value_format) in some browsers.
383
-
384
- *Alex Ghiculescu*
385
-
386
- * Improve error messages when template file does not exist at absolute filepath.
331
+ * Move `convert_to_model` call from `form_for` into `form_with`
387
332
 
388
- *Ted Whang*
333
+ Now that `form_for` is implemented in terms of `form_with`, remove the
334
+ `convert_to_model` call from `form_for`.
389
335
 
390
- * Add `:country_code` option to `sms_to` for consistency with `phone_to`.
391
-
392
- *Jonathan Hefner*
393
-
394
- * OpenSSL constants are now used for Digest computations.
336
+ *Sean Doyle*
395
337
 
396
- *Dirkjan Bussink*
338
+ * Fix and add protections for XSS in `ActionView::Helpers` and `ERB::Util`.
397
339
 
398
- * The `translate` helper now passes `default` values that aren't
399
- translation keys through `I18n.translate` for interpolation.
340
+ Escape dangerous characters in names of tags and names of attributes in the
341
+ tag helpers, following the XML specification. Rename the option
342
+ `:escape_attributes` to `:escape`, to simplify by applying the option to the
343
+ whole tag.
400
344
 
401
- *Jonathan Hefner*
345
+ *Álvaro Martín Fraguas*
402
346
 
403
- * Adds option `extname` to `stylesheet_link_tag` to skip default
404
- `.css` extension appended to the stylesheet path.
347
+ * Extend audio_tag and video_tag to accept Active Storage attachments.
405
348
 
406
- Before:
349
+ Now it's possible to write
407
350
 
408
351
  ```ruby
409
- stylesheet_link_tag "style.less"
410
- # <link href="/stylesheets/style.less.scss" rel="stylesheet">
352
+ audio_tag(user.audio_file)
353
+ video_tag(user.video_file)
411
354
  ```
412
355
 
413
- After:
356
+ Instead of
414
357
 
415
358
  ```ruby
416
- stylesheet_link_tag "style.less", extname: false, skip_pipeline: true, rel: "stylesheet/less"
417
- # <link href="/stylesheets/style.less" rel="stylesheet/less">
359
+ audio_tag(polymorphic_path(user.audio_file))
360
+ video_tag(polymorphic_path(user.video_file))
418
361
  ```
419
362
 
420
- *Abhay Nikam*
421
-
422
- * Deprecate `render` locals to be assigned to instance variables.
423
-
424
- *Petrik de Heus*
425
-
426
- * Remove legacy default `media=screen` from `stylesheet_link_tag`.
363
+ `image_tag` already supported that, so this follows the same pattern.
427
364
 
428
- *André Luis Leal Cardoso Junior*
365
+ *Matheus Richard*
429
366
 
430
- * Change `ActionView::Helpers::FormBuilder#button` to transform `formmethod`
431
- attributes into `_method="$VERB"` Form Data to enable varied same-form actions:
432
-
433
- <%= form_with model: post, method: :put do %>
434
- <%= form.button "Update" %>
435
- <%= form.button "Delete", formmethod: :delete %>
436
- <% end %>
437
- <%# => <form action="posts/1">
438
- => <input type="hidden" name="_method" value="put">
439
- => <button type="submit">Update</button>
440
- => <button type="submit" formmethod="post" name="_method" value="delete">Delete</button>
441
- => </form>
442
- %>
443
-
444
- *Sean Doyle*
445
-
446
- * Change `ActionView::Helpers::UrlHelper#button_to` to *always* render a
447
- `<button>` element, regardless of whether or not the content is passed as
448
- the first argument or as a block.
449
-
450
- <%= button_to "Delete", post_path(@post), method: :delete %>
451
- # => <form action="/posts/1"><input type="hidden" name="_method" value="delete"><button type="submit">Delete</button></form>
452
-
453
- <%= button_to post_path(@post), method: :delete do %>
454
- Delete
455
- <% end %>
456
- # => <form action="/posts/1"><input type="hidden" name="_method" value="delete"><button type="submit">Delete</button></form>
457
-
458
- *Sean Doyle*, *Dusan Orlovic*
459
-
460
- * Add `config.action_view.preload_links_header` to allow disabling of
461
- the `Link` header being added by default when using `stylesheet_link_tag`
462
- and `javascript_include_tag`.
463
-
464
- *Andrew White*
465
-
466
- * The `translate` helper now resolves `default` values when a `nil` key is
467
- specified, instead of always returning `nil`.
468
-
469
- *Jonathan Hefner*
470
-
471
- * Add `config.action_view.image_loading` to configure the default value of
472
- the `image_tag` `:loading` option.
473
-
474
- By setting `config.action_view.image_loading = "lazy"`, an application can opt in to
475
- lazy loading images sitewide, without changing view code.
476
-
477
- *Jonathan Hefner*
478
-
479
- * `ActionView::Helpers::FormBuilder#id` returns the value
480
- of the `<form>` element's `id` attribute. With a `method` argument, returns
481
- the `id` attribute for a form field with that name.
482
-
483
- <%= form_for @post do |f| %>
484
- <%# ... %>
485
-
486
- <% content_for :sticky_footer do %>
487
- <%= form.button(form: f.id) %>
488
- <% end %>
489
- <% end %>
490
-
491
- *Sean Doyle*
492
-
493
- * `ActionView::Helpers::FormBuilder#field_id` returns the value generated by
494
- the FormBuilder for the given attribute name.
495
-
496
- <%= form_for @post do |f| %>
497
- <%= f.label :title %>
498
- <%= f.text_field :title, aria: { describedby: f.field_id(:title, :error) } %>
499
- <%= tag.span("is blank", id: f.field_id(:title, :error) %>
500
- <% end %>
501
-
502
- *Sean Doyle*
503
-
504
- * Add `tag.attributes` to transform a Hash into HTML Attributes, ready to be
505
- interpolated into ERB.
506
-
507
- <input <%= tag.attributes(type: :text, aria: { label: "Search" }) %> >
508
- # => <input type="text" aria-label="Search">
367
+ * Ensure models passed to `form_for` attempt to call `to_model`.
509
368
 
510
369
  *Sean Doyle*
511
370
 
512
-
513
- Please check [6-1-stable](https://github.com/rails/rails/blob/6-1-stable/actionview/CHANGELOG.md) for previous changes.
371
+ Please check [7-0-stable](https://github.com/rails/rails/blob/7-0-stable/actionview/CHANGELOG.md) for previous changes.