Contents

# frozen_string_literal: true

module Pages
	class Rails::RenderingViews < ApplicationPage
		def template
			render Layout.new(title: "Getting started with Rails") do
				render Markdown.new <<~MD
					# Rendering Phlex views in Rails

					You can render a `Phlex::HTML` from your Rails controller actions as well as other views, and even from ActionView / ViewComponent templates.

					Instead of implicitly rendering an ERB template with automatic access to all your controller instance variables, you need to explicitly render Phlex views from your controller action methods.

					Doing this allows you to design views without implicit dependencies on controller instance variables, making them much easier to test and reuse and reason about.

					```ruby
					class ArticlesController < ApplicationController
						def index
							render Views::Articles::Index.new(
								articles: Article.all.load_async
							)
						end

						def show
							render Views::Articles::Show.new(
								article: Article.find(params[:id])
							)
						end
					end
					```
				MD
			end
		end
	end
end

Version data entries

4 entries across 4 versions & 1 rubygems

Version	Path
phlex-0.5.3	docs/pages/rails/rendering_views.rb
phlex-0.5.2	docs/pages/rails/rendering_views.rb
phlex-0.5.1	docs/pages/rails/rendering_views.rb
phlex-0.5.0	docs/pages/rails/rendering_views.rb