actionview 7.0.8 → 7.1.0.beta1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
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.