mirror of
https://github.com/rails/rails.git
synced 2022-11-09 12:12:34 -05:00
7cf52ae981
This commit extends the `ActionView::Helpers#translate` (and by way of
alias, `#t`) helper methods to accept blocks.
When invoked with a block, the `translate` call will yield the
translated text as its first block argument, along with the resolved
translation key as its second:
```erb
<%= translate(".key") do |translation, resolved_key| %>
<span data-i18n-key="<%= resolved_key %>"><%= translation %></span>
<% end %>
```
In cases where relative translation keys are foregone in lieu of fully
qualified keys, or if the caller is not interested in the resolved key,
the second block argument can be omitted:
```erb
<%= translate("action.template.key") do |translation| %>
<p><%= translation %></p>
<p><%= translation %>, but a second time</p>
<% end %>
```
A benefit of yielding the translation is that it enabled template-local
variable re-use. Alternatively, [`Object#tap`][tap] could be used.
Prior to this commit, however, the resolution of the translation key was
internal to `ActionView`, and unavailable to the caller (unless they
were willing to explicitly determine the resolved key themselves). By
making it available as a block parameter, it could be used to annotate
the translated value in the resulting elements.
[tap]: https://ruby-doc.org/core-2.7.0/Object.html#method-i-tap
114 lines
3.8 KiB
Markdown
114 lines
3.8 KiB
Markdown
* `ActionView::Helpers::TranslationHelper#translate` accepts a block, yielding
|
|
the translated text and the fully resolved translation key:
|
|
|
|
<%= translate(".relative_key") do |translation, resolved_key| %>
|
|
<span title="<%= resolved_key %>"><%= translation %></span>
|
|
<% end %>
|
|
|
|
*Sean Doyle*
|
|
|
|
* Ensure cache fragment digests include all relevant template dependencies when
|
|
fragments are contained in a block passed to the render helper. Remove the
|
|
virtual_path keyword arguments found in CacheHelper as they no longer possess
|
|
any function following 1581cab.
|
|
|
|
Fixes #38984.
|
|
|
|
*Aaron Lipman*
|
|
|
|
* Deprecate `config.action_view.raise_on_missing_translations` in favor of
|
|
`config.i18n.raise_on_missing_translations`.
|
|
|
|
New generalized configuration option now determines whether an error should be raised
|
|
for missing translations in controllers and views.
|
|
|
|
*fatkodima*
|
|
|
|
* Instrument layout rendering in `TemplateRenderer#render_with_layout` as `render_layout.action_view`,
|
|
and include (when necessary) the layout's virtual path in notification payloads for collection and partial renders.
|
|
|
|
*Zach Kemp*
|
|
|
|
* `ActionView::Base.annotate_rendered_view_with_filenames` annotates HTML output with template file names.
|
|
|
|
*Joel Hawksley*, *Aaron Patterson*
|
|
|
|
* `ActionView::Helpers::TranslationHelper#translate` returns nil when
|
|
passed `default: nil` without a translation matching `I18n#translate`.
|
|
|
|
*Stefan Wrobel*
|
|
|
|
* `OptimizedFileSystemResolver` prefers template details in order of locale,
|
|
formats, variants, handlers.
|
|
|
|
*Iago Pimenta*
|
|
|
|
* Added `class_names` helper to create a CSS class value with conditional classes.
|
|
|
|
*Joel Hawksley*, *Aaron Patterson*
|
|
|
|
* Add support for conditional values to TagBuilder.
|
|
|
|
*Joel Hawksley*
|
|
|
|
* `ActionView::Helpers::FormOptionsHelper#select` should mark option for `nil` as selected.
|
|
|
|
```ruby
|
|
@post = Post.new
|
|
@post.category = nil
|
|
|
|
# Before
|
|
select("post", "category", none: nil, programming: 1, economics: 2)
|
|
# =>
|
|
# <select name="post[category]" id="post_category">
|
|
# <option value="">none</option>
|
|
# <option value="1">programming</option>
|
|
# <option value="2">economics</option>
|
|
# </select>
|
|
|
|
# After
|
|
select("post", "category", none: nil, programming: 1, economics: 2)
|
|
# =>
|
|
# <select name="post[category]" id="post_category">
|
|
# <option selected="selected" value="">none</option>
|
|
# <option value="1">programming</option>
|
|
# <option value="2">economics</option>
|
|
# </select>
|
|
```
|
|
|
|
*bogdanvlviv*
|
|
|
|
* Log lines for partial renders and started template renders are now
|
|
emitted at the `DEBUG` level instead of `INFO`.
|
|
|
|
Completed template renders are still logged at the `INFO` level.
|
|
|
|
*DHH*
|
|
|
|
* ActionView::Helpers::SanitizeHelper: support rails-html-sanitizer 1.1.0.
|
|
|
|
*Juanito Fatas*
|
|
|
|
* Added `phone_to` helper method to create a link from mobile numbers.
|
|
|
|
*Pietro Moro*
|
|
|
|
* annotated_source_code returns an empty array so TemplateErrors without a
|
|
template in the backtrace are surfaced properly by DebugExceptions.
|
|
|
|
*Guilherme Mansur*, *Kasper Timm Hansen*
|
|
|
|
* Add autoload for SyntaxErrorInTemplate so syntax errors are correctly raised by DebugExceptions.
|
|
|
|
*Guilherme Mansur*, *Gannon McGibbon*
|
|
|
|
* `RenderingHelper` supports rendering objects that `respond_to?` `:render_in`.
|
|
|
|
*Joel Hawksley*, *Natasha Umer*, *Aaron Patterson*, *Shawn Allen*, *Emily Plummer*, *Diana Mounter*, *John Hawthorn*, *Nathan Herald*, *Zaid Zawaideh*, *Zach Ahn*
|
|
|
|
* Fix `select_tag` so that it doesn't change `options` when `include_blank` is present.
|
|
|
|
*Younes SERRAJ*
|
|
|
|
|
|
Please check [6-0-stable](https://github.com/rails/rails/blob/6-0-stable/actionview/CHANGELOG.md) for previous changes.
|