mirror of https://github.com/rails/rails
a9148b45f3
Motivation / Background --- While the `ActionView::TestCase` class isn't marked with a `:nodoc:` comment to indicate that it's internal to Rails, there isn't much content in the guides that explains how to test view partials. Libraries like [view_component](https://github.com/ViewComponent/view_component/) have [built-in support for testing](https://viewcomponent.org/guide/testing.html), including Capybara integration. While `ActionView::TestCase` already integrates with `rails-dom-testing`, that integration could be better documented. Additionally, it wouldn't take much for consuming applications to mimic the ViewComponent testing experience for their Action View Partials. Details --- First, link to the "Testing Rails Applications" page from the `ActionView::TestCase` class documentation. Next, add a "Testing View Partials" section to the guides that expands upon the variety of tooling available to tests that inherit from `ActionView::TestCase`. In that section, cover topics like: * the `render` helper method * the `rendered` helper attribute reader * calls to `assert_select` with attribute placeholders * the `document_root_element` helper method * integration with Ruby's Pattern Matching * opportunities to integrate with Capybara Additional Information --- Additionally, add test coverage that exercise the examples shared in the new section, including: * Calls to `assert_select` that utilize attribute placeholders * Ruby 3.0's Pattern Matching * Integration with Capybara |
||
|---|---|---|
| .. | ||
| app | ||
| bin | ||
| lib | ||
| test | ||
| .eslintrc | ||
| .gitignore | ||
| CHANGELOG.md | ||
| MIT-LICENSE | ||
| README.rdoc | ||
| RUNNING_UJS_TESTS.rdoc | ||
| RUNNING_UNIT_TESTS.rdoc | ||
| Rakefile | ||
| actionview.gemspec | ||
| karma.conf.js | ||
| package.json | ||
| rollup.config.js | ||
| rollup.config.test.js | ||
README.rdoc
= Action View
Action View is a framework for handling view template lookup and rendering, and provides
view helpers that assist when building HTML forms, Atom feeds and more.
Template formats that Action View handles are ERB (embedded Ruby, typically
used to inline short Ruby snippets inside HTML), and XML Builder.
You can read more about Action View in the {Action View Overview}[https://guides.rubyonrails.org/action_view_overview.html] guide.
== Download and installation
The latest version of Action View can be installed with RubyGems:
$ gem install actionview
Source code can be downloaded as part of the \Rails project on GitHub:
* https://github.com/rails/rails/tree/main/actionview
== License
Action View is released under the MIT license:
* https://opensource.org/licenses/MIT
== Support
API documentation is at
* https://api.rubyonrails.org
Bug reports for the Ruby on \Rails project can be filed here:
* https://github.com/rails/rails/issues
Feature requests should be discussed on the rails-core mailing list here:
* https://discuss.rubyonrails.org/c/rubyonrails-core