mirror of
https://github.com/rails/rails.git
synced 2022-11-09 12:12:34 -05:00
59ca21c011
`ActionView::Helpers::FormBuilder#id`
---
Generate an HTML `id` attribute value.
Return the [`<form>` element's][mdn-form] `id` attribute.
```html+erb
<%= form_for @post do |f| %>
<%# ... %>
<% content_for :sticky_footer do %>
<%= form.button(form: f.id) %>
<% end %>
<% end %>
```
In the example above, the `:sticky_footer` content area will exist
outside of the `<form>` element. [By declaring the `form` HTML
attribute][mdn-button-attr-form], we hint to the browser that the
generated `<button>` element should be treated as the `<form>` element's
submit button, regardless of where it exists in the DOM.
[A similar pattern could be used for `<input>`
elements][mdn-input-attr-form] (or other form controls) that do not
descend from the `<form>` element.
`ActionView::Helpers::FormBuilder#field_id`
---
Generate an HTML <tt>id</tt> attribute value for the given field
Return the value generated by the <tt>FormBuilder</tt> for the given
attribute name.
```html+erb
<%= form_for @post do |f| %>
<%= f.label :title %>
<%= f.text_field :title, aria: { describedby: form.field_id(:title, :error) } %>
<span id="<%= f.field_id(:title, :error) %>">is blank</span>
<% end %>
```
In the example above, the <tt><input type="text"></tt> element built by
the call to <tt>FormBuilder#text_field</tt> declares an
<tt>aria-describedby</tt> attribute referencing the <tt><span></tt>
element, sharing a common <tt>id</tt> root (<tt>post_title</tt>, in this
case).
This method is powered by the `field_id` helper declared in
`action_view/helpers/form_tag_helper`, which is made available for
general template calls, separate from a `FormBuilder` instance.
[mdn-form]: https://developer.mozilla.org/en-US/docs/Web/HTML/Element/form
[mdn-button-attr-form]: https://developer.mozilla.org/en-US/docs/Web/HTML/Element/button#attr-form
[mdn-input-attr-form]: https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#attr-form
[mdn-aria-describedby]: https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/ARIA_Techniques/Using_the_aria-describedby_attribute
[w3c-wai]: https://www.w3.org/WAI/tutorials/forms/notifications/#listing-errors
|
||
|---|---|---|
| .. | ||
| erb | ||
| form_helper | ||
| testing | ||
| active_model_helper_test.rb | ||
| asset_tag_helper_test.rb | ||
| atom_feed_helper_test.rb | ||
| capture_helper_test.rb | ||
| compiled_templates_test.rb | ||
| controller_helper_test.rb | ||
| csp_helper_test.rb | ||
| csrf_helper_test.rb | ||
| date_helper_i18n_test.rb | ||
| date_helper_test.rb | ||
| dependency_tracker_test.rb | ||
| digestor_test.rb | ||
| erb_util_test.rb | ||
| fallback_file_system_resolver_test.rb | ||
| file_system_resolver_test.rb | ||
| form_collections_helper_test.rb | ||
| form_helper_test.rb | ||
| form_options_helper_i18n_test.rb | ||
| form_options_helper_test.rb | ||
| form_tag_helper_test.rb | ||
| html_test.rb | ||
| javascript_helper_test.rb | ||
| log_subscriber_test.rb | ||
| lookup_context_test.rb | ||
| number_helper_test.rb | ||
| optimized_file_system_resolver_test.rb | ||
| output_safety_helper_test.rb | ||
| partial_iteration_test.rb | ||
| record_identifier_test.rb | ||
| render_test.rb | ||
| resolver_cache_test.rb | ||
| resolver_shared_tests.rb | ||
| sanitize_helper_test.rb | ||
| streaming_render_test.rb | ||
| tag_helper_test.rb | ||
| template_error_test.rb | ||
| template_test.rb | ||
| test_case_test.rb | ||
| test_test.rb | ||
| text_helper_test.rb | ||
| text_test.rb | ||
| translation_helper_test.rb | ||
| url_helper_test.rb | ||