actionview 7.0.8 → 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 -357
  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 +25 -25
data/CHANGELOG.md CHANGED
@@ -1,34 +1,25 @@
1
- ## Rails 7.0.8 (September 09, 2023) ##
1
+ ## Rails 7.1.0.beta1 (September 13, 2023) ##
2
2
 
3
- * Fix `form_for` missing the hidden `_method` input for models with a
4
- namespaced route.
3
+ * Fix `simple_format` with blank `wrapper_tag` option returns plain html tag
5
4
 
6
- *Hartley McGuire*
7
-
8
- * Fix `render collection: @records, cache: true` inside `jbuilder` templates
9
-
10
- The previous fix that shipped in `7.0.7` assumed template fragments are always strings,
11
- this isn't true with `jbuilder`.
12
-
13
- *Jean Boussier*
14
-
15
- ## Rails 7.0.7.2 (August 22, 2023) ##
16
-
17
- * No changes.
18
-
19
-
20
- ## Rails 7.0.7.1 (August 22, 2023) ##
21
-
22
- * No changes.
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.
23
7
 
8
+ Before:
24
9
 
25
- ## Rails 7.0.7 (August 09, 2023) ##
10
+ ```ruby
11
+ simple_format("Hello World", {}, { wrapper_tag: nil })
12
+ # <>Hello World</>
13
+ ```
26
14
 
27
- * Fix `render collection: @records, cache: true` to cache fragments as bare strings
15
+ After:
28
16
 
29
- 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
+ ```
30
21
 
31
- *Jean Boussier*
22
+ *Akhil G Krishnan*, *Junichi Ito*
32
23
 
33
24
  * Don't double-encode nested `field_id` and `field_name` index values
34
25
 
@@ -37,457 +28,344 @@
37
28
 
38
29
  *Sean Doyle*
39
30
 
31
+ * Allow opting in/out of `Link preload` headers when calling `stylesheet_link_tag` or `javascript_include_tag`
40
32
 
41
- ## Rails 7.0.6 (June 29, 2023) ##
42
-
43
- * No changes.
44
-
45
-
46
- ## Rails 7.0.5.1 (June 26, 2023) ##
47
-
48
- * 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)
49
36
 
37
+ # will include header, even if setting is disabled:
38
+ stylesheet_link_tag("http://example.com/all.js", preload_links_header: true)
39
+ ```
50
40
 
51
- ## Rails 7.0.5 (May 24, 2023) ##
41
+ *Alex Ghiculescu*
52
42
 
53
- * `FormBuilder#id` finds id set by `form_for` and `form_with`.
43
+ * Stop generating `Link preload` headers once it has reached 1KB.
54
44
 
55
- *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.
56
47
 
57
- * 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.
58
50
 
59
- *Ben Dilley*
51
+ *Jean Boussier*
60
52
 
61
- * Choices of `select` can optionally contain html attributes as the last element
62
- 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.
63
54
 
64
- ```erb
65
- <%= form.select :foo, [["North America", [["United States","US"],["Canada","CA"]], { disabled: "disabled" }]] %>
66
- # => <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>"
67
59
  ```
68
60
 
69
- *Chris Gunther*
70
-
71
-
72
- ## 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
+ ```
73
66
 
74
- * Ignore certain data-* attributes in rails-ujs when element is contenteditable
67
+ *Andrei Andriichuk*
75
68
 
76
- [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.
77
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`.
78
75
 
79
- ## 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`.
80
79
 
81
- * No changes.
80
+ *Mike Dalessio*
82
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.
83
85
 
84
- ## 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.
85
89
 
86
- * No changes.
90
+ *Mike Dalessio*
87
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.
88
96
 
89
- ## 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
+ ```
90
107
 
91
- * Guard against `ActionView::Helpers::FormTagHelper#field_name` calls with nil
92
- `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
+ ```
93
120
 
121
+ Full control via a block:
94
122
  ```erb
95
- <%= fields do |f| %>
96
- <%= 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") %>
97
127
  <% end %>
98
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
+ ```
99
137
 
100
- *Sean Doyle*
101
-
102
- * Strings returned from `strip_tags` are correctly tagged `html_safe?`
103
-
104
- Because these strings contain no HTML elements and the basic entities are escaped, they are safe
105
- to be included as-is as PCDATA in HTML content. Tagging them as html-safe avoids double-escaping
106
- entities when being concatenated to a SafeBuffer during rendering.
107
-
108
- Fixes [rails/rails-html-sanitizer#124](https://github.com/rails/rails-html-sanitizer/issues/124)
138
+ *Juan Pablo Balarini*
109
139
 
110
- *Mike Dalessio*
140
+ * Remove deprecated support to passing instance variables as locals to partials.
111
141
 
112
- ## Rails 7.0.3.1 (July 12, 2022) ##
142
+ *Rafael Mendonça França*
113
143
 
114
- * No changes.
144
+ * Remove deprecated constant `ActionView::Path`.
115
145
 
146
+ *Rafael Mendonça França*
116
147
 
117
- ## Rails 7.0.3 (May 09, 2022) ##
118
-
119
- * Ensure models passed to `form_for` attempt to call `to_model`.
148
+ * Guard `token_list` calls from escaping HTML too often
120
149
 
121
150
  *Sean Doyle*
122
151
 
123
- ## Rails 7.0.2.4 (April 26, 2022) ##
124
-
125
- * Fix and add protections for XSS in `ActionView::Helpers` and `ERB::Util`.
126
-
127
- Escape dangerous characters in names of tags and names of attributes in the
128
- tag helpers, following the XML specification. Rename the option
129
- `:escape_attributes` to `:escape`, to simplify by applying the option to the
130
- whole tag.
131
-
132
- *Álvaro Martín Fraguas*
133
-
134
- ## Rails 7.0.2.3 (March 08, 2022) ##
135
-
136
- * No changes.
137
-
138
-
139
- ## Rails 7.0.2.2 (February 11, 2022) ##
140
-
141
- * No changes.
142
-
143
-
144
- ## Rails 7.0.2.1 (February 11, 2022) ##
145
-
146
- * No changes.
152
+ * `select` can now be called with a single hash containing options and some HTML options
147
153
 
154
+ Previously this would not work as expected:
148
155
 
149
- ## Rails 7.0.2 (February 08, 2022) ##
150
-
151
- * Ensure `preload_link_tag` preloads JavaScript modules correctly.
152
-
153
- *Máximo Mussini*
154
-
155
- * Fix `stylesheet_link_tag` and similar helpers are being used to work in objects with
156
- a `response` method.
157
-
158
- *dark-panda*
159
-
160
-
161
- ## Rails 7.0.1 (January 06, 2022) ##
156
+ ```erb
157
+ <%= select :post, :author, authors, required: true %>
158
+ ```
162
159
 
163
- * Fix `button_to` to work with a hash parameter as URL.
160
+ Instead you needed to do this:
164
161
 
165
- *MingyuanQin*
162
+ ```erb
163
+ <%= select :post, :author, authors, {}, required: true %>
164
+ ```
166
165
 
167
- * 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`.
168
167
 
169
168
  *Alex Ghiculescu*
170
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.
171
171
 
172
- ## Rails 7.0.0 (December 15, 2021) ##
173
-
174
- * Support `include_hidden:` option in calls to
175
- `ActionView::Helper::FormBuilder#file_field` with `multiple: true` to
176
- support submitting an empty collection of files.
177
-
178
- ```ruby
179
- form.file_field :attachments, multiple: true
180
- # => <input type="hidden" autocomplete="off" name="post[attachments][]" value="">
181
- <input type="file" multiple="multiple" id="post_attachments" name="post[attachments][]">
182
-
183
- form.file_field :attachments, multiple: true, include_hidden: false
184
- # => <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") %>
185
175
  ```
186
176
 
187
- *Sean Doyle*
188
-
189
- * Fix `number_with_precision(raise: true)` always raising even on valid numbers.
190
-
191
- *Pedro Moreira*
177
+ After:
178
+ ```erb
179
+ <%= form.datetime_field :written_at, value: Time.current %>
180
+ ```
192
181
 
182
+ *Andrey Samsonov*
193
183
 
194
- ## 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
195
186
 
196
- * 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
+ ```
197
191
 
192
+ *Chris Gunther*
198
193
 
199
- ## Rails 7.0.0.rc2 (December 14, 2021) ##
194
+ * `check_box_tag` and `radio_button_tag` now accept `checked` as a keyword argument
200
195
 
201
- * 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:
202
198
 
203
- ## 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
204
202
 
205
- * Support `fields model: [@nested, @model]` the same way as `form_with model:
206
- [@nested, @model]`.
203
+ = radio_button_tag 'favorite_color', 'maroon', false
204
+ = radio_button_tag 'favorite_color', 'maroon', checked: false
205
+ ```
207
206
 
208
- *Sean Doyle*
207
+ *Alex Ghiculescu*
209
208
 
210
- * Infer HTTP verb `[method]` from a model or Array with model as the first
211
- 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.
212
214
 
215
+ Before:
213
216
  ```ruby
214
- button_to(Workshop.find(1)){ "Update" }
215
- #=> <form method="post" action="/workshops/1" class="button_to">
216
- #=> <input type="hidden" name="_method" value="patch" autocomplete="off" />
217
- #=> <button type="submit">Update</button>
218
- #=> </form>
219
-
220
- button_to([ Workshop.find(1), Session.find(1) ]) { "Update" }
221
- #=> <form method="post" action="/workshops/1/sessions/1" class="button_to">
222
- #=> <input type="hidden" name="_method" value="patch" autocomplete="off" />
223
- #=> <button type="submit">Update</button>
224
- #=> </form>
217
+ dom_id(Post) # => NoMethodError: undefined method `to_key' for Post:Class
225
218
  ```
226
219
 
227
- *Sean Doyle*
228
-
229
- * Support passing a Symbol as the first argument to `FormBuilder#button`:
230
-
220
+ After:
231
221
  ```ruby
232
- form.button(:draft, value: true)
233
- # => <button name="post[draft]" value="true" type="submit">Create post</button>
234
-
235
- form.button(:draft, value: true) do
236
- content_tag(:strong, "Save as draft")
237
- end
238
- # => <button name="post[draft]" value="true" type="submit">
239
- # <strong>Save as draft</strong>
240
- # </button>
222
+ dom_id(Post) # => "new_post"
241
223
  ```
242
224
 
243
- *Sean Doyle*
225
+ *Goulven Champenois*
244
226
 
245
- * Introduce the `field_name` view helper, along with the
246
- `FormBuilder#field_name` counterpart:
227
+ * Report `:locals` as part of the data returned by ActionView render instrumentation.
247
228
 
229
+ Before:
248
230
  ```ruby
249
- form_for @post do |f|
250
- f.field_tag :tag, name: f.field_name(:tag, multiple: true)
251
- # => <input type="text" name="post[tag][]">
252
- end
231
+ {
232
+ identifier: "/Users/adam/projects/notifications/app/views/posts/index.html.erb",
233
+ layout: "layouts/application"
234
+ }
253
235
  ```
254
236
 
255
- *Sean Doyle*
256
-
257
- * Execute the `ActionView::Base.field_error_proc` within the context of the
258
- `ActionView::Base` instance:
259
-
237
+ After:
260
238
  ```ruby
261
- 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
+ }
262
244
  ```
263
245
 
264
- *Sean Doyle*
246
+ *Aaron Gough*
265
247
 
266
- * Add support for `button_to ..., authenticity_token: false`
248
+ * Strip `break_sequence` at the end of `word_wrap`.
267
249
 
268
- ```ruby
269
- button_to "Create", Post.new, authenticity_token: false
270
- # => <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.
271
251
 
272
- button_to "Create", Post.new, authenticity_token: true
273
- # => <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:
274
253
 
275
- button_to "Create", Post.new, authenticity_token: "secret"
276
- # => <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# ") %>
277
256
  ```
278
257
 
279
- *Sean Doyle*
280
-
281
- * Support rendering `<form>` elements _without_ `[action]` attributes by:
258
+ Before:
282
259
 
283
- * `form_with url: false` or `form_with ..., html: { action: false }`
284
- * `form_for ..., url: false` or `form_for ..., html: { action: false }`
285
- * `form_tag false` or `form_tag ..., action: false`
286
- * `button_to "...", false` or `button_to(false) { ... }`
260
+ ```
261
+ # 11
262
+ # 22
263
+ #
264
+ # 33
265
+ # 44
266
+ #
267
+ ```
287
268
 
288
- *Sean Doyle*
269
+ After:
289
270
 
290
- * Add `:day_format` option to `date_select`
271
+ ```
272
+ # 11
273
+ # 22
274
+ # 33
275
+ # 44
276
+ ```
291
277
 
292
- date_select("article", "written_on", day_format: ->(day) { day.ordinalize })
293
- # generates day options like <option value="1">1st</option>\n<option value="2">2nd</option>...
278
+ *Max Chernyak*
294
279
 
295
- *Shunichi Ikegami*
280
+ * Allow templates to set strict `locals`.
296
281
 
297
- * Allow `link_to` helper to infer link name from `Model#to_s` when it
298
- 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:
299
283
 
300
- link_to @profile
301
- #=> <a href="/profiles/1">Eileen</a>
284
+ ```erb
285
+ <%# locals: (message:) -%>
286
+ <%= message %>
287
+ ```
302
288
 
303
- This assumes the model class implements a `to_s` method like this:
289
+ Default values can also be provided:
304
290
 
305
- class Profile < ApplicationRecord
306
- # ...
307
- def to_s
308
- name
309
- end
310
- end
291
+ ```erb
292
+ <%# locals: (message: "Hello, world!") -%>
293
+ <%= message %>
294
+ ```
311
295
 
312
- Previously you had to supply a second argument even if the `Profile`
313
- model implemented a `#to_s` method that called the `name` method.
296
+ Or `locals` can be disabled entirely:
314
297
 
315
- link_to @profile, @profile.name
316
- #=> <a href="/profiles/1">Eileen</a>
298
+ ```erb
299
+ <%# locals: () %>
300
+ ```
317
301
 
318
- *Olivier Lacan*
302
+ *Joel Hawksley*
319
303
 
320
- * Support svg unpaired tags for `tag` helper.
304
+ * Add `include_seconds` option for `datetime_local_field`
321
305
 
322
- tag.svg { tag.use('href' => "#cool-icon") }
323
- # => <svg><use href="#cool-icon"></svg>
306
+ This allows to omit seconds part in the input field, by passing `include_seconds: false`
324
307
 
325
- *Oleksii Vasyliev*
308
+ *Wojciech Wnętrzak*
326
309
 
310
+ * Guard against `ActionView::Helpers::FormTagHelper#field_name` calls with nil
311
+ `object_name` arguments. For example:
327
312
 
328
- ## Rails 7.0.0.alpha2 (September 15, 2021) ##
313
+ ```erb
314
+ <%= fields do |f| %>
315
+ <%= f.field_name :body %>
316
+ <% end %>
317
+ ```
329
318
 
330
- * No changes.
319
+ *Sean Doyle*
331
320
 
321
+ * Strings returned from `strip_tags` are correctly tagged `html_safe?`
332
322
 
333
- ## 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.
334
326
 
335
- * Improves the performance of ActionView::Helpers::NumberHelper formatters by avoiding the use of
336
- exceptions as flow control.
327
+ Fixes [rails/rails-html-sanitizer#124](https://github.com/rails/rails-html-sanitizer/issues/124)
337
328
 
338
329
  *Mike Dalessio*
339
330
 
340
- * `preload_link_tag` properly inserts `as` attributes for files with `image` MIME types, such as JPG or SVG.
341
-
342
- *Nate Berkopec*
343
-
344
- * Add `weekday_options_for_select` and `weekday_select` helper methods. Also adds `weekday_select` to `FormBuilder`.
331
+ * Move `convert_to_model` call from `form_for` into `form_with`
345
332
 
346
- *Drew Bragg*, *Dana Kashubeck*, *Kasper Timm Hansen*
333
+ Now that `form_for` is implemented in terms of `form_with`, remove the
334
+ `convert_to_model` call from `form_for`.
347
335
 
348
- * 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.
349
-
350
- *Ben Toews*, *John Hawthorn*, *Kasper Timm Hansen*, *Joel Hawksley*
351
-
352
- * Add `include_seconds` option for `time_field`.
353
-
354
- <%= form.time_field :foo, include_seconds: false %>
355
- # => <input value="16:22" type="time" />
356
-
357
- Default includes seconds:
358
-
359
- <%= form.time_field :foo %>
360
- # => <input value="16:22:01.440" type="time" />
361
-
362
- 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.
363
-
364
- *Alex Ghiculescu*
365
-
366
- * Improve error messages when template file does not exist at absolute filepath.
367
-
368
- *Ted Whang*
369
-
370
- * Add `:country_code` option to `sms_to` for consistency with `phone_to`.
371
-
372
- *Jonathan Hefner*
373
-
374
- * OpenSSL constants are now used for Digest computations.
336
+ *Sean Doyle*
375
337
 
376
- *Dirkjan Bussink*
338
+ * Fix and add protections for XSS in `ActionView::Helpers` and `ERB::Util`.
377
339
 
378
- * The `translate` helper now passes `default` values that aren't
379
- 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.
380
344
 
381
- *Jonathan Hefner*
345
+ *Álvaro Martín Fraguas*
382
346
 
383
- * Adds option `extname` to `stylesheet_link_tag` to skip default
384
- `.css` extension appended to the stylesheet path.
347
+ * Extend audio_tag and video_tag to accept Active Storage attachments.
385
348
 
386
- Before:
349
+ Now it's possible to write
387
350
 
388
351
  ```ruby
389
- stylesheet_link_tag "style.less"
390
- # <link href="/stylesheets/style.less.scss" rel="stylesheet">
352
+ audio_tag(user.audio_file)
353
+ video_tag(user.video_file)
391
354
  ```
392
355
 
393
- After:
356
+ Instead of
394
357
 
395
358
  ```ruby
396
- stylesheet_link_tag "style.less", extname: false, skip_pipeline: true, rel: "stylesheet/less"
397
- # <link href="/stylesheets/style.less" rel="stylesheet/less">
359
+ audio_tag(polymorphic_path(user.audio_file))
360
+ video_tag(polymorphic_path(user.video_file))
398
361
  ```
399
362
 
400
- *Abhay Nikam*
401
-
402
- * Deprecate `render` locals to be assigned to instance variables.
403
-
404
- *Petrik de Heus*
405
-
406
- * Remove legacy default `media=screen` from `stylesheet_link_tag`.
407
-
408
- *André Luis Leal Cardoso Junior*
363
+ `image_tag` already supported that, so this follows the same pattern.
409
364
 
410
- * Change `ActionView::Helpers::FormBuilder#button` to transform `formmethod`
411
- attributes into `_method="$VERB"` Form Data to enable varied same-form actions:
365
+ *Matheus Richard*
412
366
 
413
- <%= form_with model: post, method: :put do %>
414
- <%= form.button "Update" %>
415
- <%= form.button "Delete", formmethod: :delete %>
416
- <% end %>
417
- <%# => <form action="posts/1">
418
- => <input type="hidden" name="_method" value="put">
419
- => <button type="submit">Update</button>
420
- => <button type="submit" formmethod="post" name="_method" value="delete">Delete</button>
421
- => </form>
422
- %>
423
-
424
- *Sean Doyle*
425
-
426
- * Change `ActionView::Helpers::UrlHelper#button_to` to *always* render a
427
- `<button>` element, regardless of whether or not the content is passed as
428
- the first argument or as a block.
429
-
430
- <%= button_to "Delete", post_path(@post), method: :delete %>
431
- # => <form action="/posts/1"><input type="hidden" name="_method" value="delete"><button type="submit">Delete</button></form>
432
-
433
- <%= button_to post_path(@post), method: :delete do %>
434
- Delete
435
- <% end %>
436
- # => <form action="/posts/1"><input type="hidden" name="_method" value="delete"><button type="submit">Delete</button></form>
437
-
438
- *Sean Doyle*, *Dusan Orlovic*
439
-
440
- * Add `config.action_view.preload_links_header` to allow disabling of
441
- the `Link` header being added by default when using `stylesheet_link_tag`
442
- and `javascript_include_tag`.
443
-
444
- *Andrew White*
445
-
446
- * The `translate` helper now resolves `default` values when a `nil` key is
447
- specified, instead of always returning `nil`.
448
-
449
- *Jonathan Hefner*
450
-
451
- * Add `config.action_view.image_loading` to configure the default value of
452
- the `image_tag` `:loading` option.
453
-
454
- By setting `config.action_view.image_loading = "lazy"`, an application can opt in to
455
- lazy loading images sitewide, without changing view code.
456
-
457
- *Jonathan Hefner*
458
-
459
- * `ActionView::Helpers::FormBuilder#id` returns the value
460
- of the `<form>` element's `id` attribute. With a `method` argument, returns
461
- the `id` attribute for a form field with that name.
462
-
463
- <%= form_for @post do |f| %>
464
- <%# ... %>
465
-
466
- <% content_for :sticky_footer do %>
467
- <%= form.button(form: f.id) %>
468
- <% end %>
469
- <% end %>
470
-
471
- *Sean Doyle*
472
-
473
- * `ActionView::Helpers::FormBuilder#field_id` returns the value generated by
474
- the FormBuilder for the given attribute name.
475
-
476
- <%= form_for @post do |f| %>
477
- <%= f.label :title %>
478
- <%= f.text_field :title, aria: { describedby: f.field_id(:title, :error) } %>
479
- <%= tag.span("is blank", id: f.field_id(:title, :error) %>
480
- <% end %>
481
-
482
- *Sean Doyle*
483
-
484
- * Add `tag.attributes` to transform a Hash into HTML Attributes, ready to be
485
- interpolated into ERB.
486
-
487
- <input <%= tag.attributes(type: :text, aria: { label: "Search" }) %> >
488
- # => <input type="text" aria-label="Search">
367
+ * Ensure models passed to `form_for` attempt to call `to_model`.
489
368
 
490
369
  *Sean Doyle*
491
370
 
492
-
493
- 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.