Class: ViewComponent::Preview
- Inherits:
-
Object
- Object
- ViewComponent::Preview
- Extended by:
- ActiveSupport::DescendantsTracker
- Includes:
- ActionView::Helpers::AssetTagHelper, ActionView::Helpers::TagHelper
- Defined in:
- lib/view_component/preview.rb
Class Method Summary collapse
-
.all ⇒ Object
Returns all component preview classes.
-
.examples ⇒ Object
Returns all of the available examples for the component preview.
-
.exists?(preview) ⇒ Boolean
Returns
true
if the preview exists. -
.find(preview) ⇒ Object
Find a component preview by its underscored class name.
-
.layout(layout_name) ⇒ Object
rubocop:disable Style/TrivialAccessors Setter for layout name.
- .load_previews ⇒ Object
-
.preview_example_template_path(example) ⇒ Object
Returns the relative path (from preview_path) to the preview example template if the template exists.
-
.preview_name ⇒ Object
Returns the underscored name of the component preview without the suffix.
-
.preview_source(example) ⇒ Object
Returns the method body for the example from the preview file.
-
.render_args(example, params: {}) ⇒ Object
Returns the arguments for rendering of the component in its layout.
Instance Method Summary collapse
- #render(component, **args, &block) ⇒ Object (also: #render_component)
- #render_with_template(template: nil, locals: {}) ⇒ Object
Class Method Details
.all ⇒ Object
Returns all component preview classes.
33 34 35 36 37 |
# File 'lib/view_component/preview.rb', line 33 def all load_previews descendants end |
.examples ⇒ Object
Returns all of the available examples for the component preview.
51 52 53 |
# File 'lib/view_component/preview.rb', line 51 def examples public_instance_methods(false).map(&:to_s).sort end |
.exists?(preview) ⇒ Boolean
Returns true
if the preview exists.
56 57 58 |
# File 'lib/view_component/preview.rb', line 56 def exists?(preview) all.any? { |p| p.preview_name == preview } end |
.find(preview) ⇒ Object
Find a component preview by its underscored class name.
61 62 63 |
# File 'lib/view_component/preview.rb', line 61 def find(preview) all.find { |p| p.preview_name == preview } end |
.layout(layout_name) ⇒ Object
rubocop:disable Style/TrivialAccessors Setter for layout name.
72 73 74 |
# File 'lib/view_component/preview.rb', line 72 def layout(layout_name) @layout = layout_name end |
.load_previews ⇒ Object
99 100 101 102 103 |
# File 'lib/view_component/preview.rb', line 99 def load_previews Array(preview_paths).each do |preview_path| Dir["#{preview_path}/**/*_preview.rb"].sort.each { |file| require_dependency file } end end |
.preview_example_template_path(example) ⇒ Object
Returns the relative path (from preview_path) to the preview example template if the template exists
78 79 80 81 82 83 84 85 86 87 88 89 90 91 |
# File 'lib/view_component/preview.rb', line 78 def preview_example_template_path(example) preview_path = Array(preview_paths).detect do |path| Dir["#{path}/#{preview_name}_preview/#{example}.html.*"].first end raise MissingPreviewTemplateError.new(example) if preview_path.nil? path = Dir["#{preview_path}/#{preview_name}_preview/#{example}.html.*"].first Pathname.new(path) .relative_path_from(Pathname.new(preview_path)) .to_s .sub(/\..*$/, "") end |
.preview_name ⇒ Object
Returns the underscored name of the component preview without the suffix.
66 67 68 |
# File 'lib/view_component/preview.rb', line 66 def preview_name name.chomp("Preview").underscore end |
.preview_source(example) ⇒ Object
Returns the method body for the example from the preview file.
94 95 96 97 |
# File 'lib/view_component/preview.rb', line 94 def preview_source(example) source = instance_method(example.to_sym).source.split("\n") source[1...(source.size - 1)].join("\n") end |
.render_args(example, params: {}) ⇒ Object
Returns the arguments for rendering of the component in its layout
40 41 42 43 44 45 46 47 48 |
# File 'lib/view_component/preview.rb', line 40 def render_args(example, params: {}) example_params_names = instance_method(example).parameters.map(&:last) provided_params = params.slice(*example_params_names).to_h.symbolize_keys result = provided_params.empty? ? new.public_send(example) : new.public_send(example, **provided_params) result ||= {} result[:template] = preview_example_template_path(example) if result[:template].nil? @layout = nil unless defined?(@layout) result.merge(layout: @layout) end |
Instance Method Details
#render(component, **args, &block) ⇒ Object Also known as: render_component
12 13 14 15 16 17 18 19 20 |
# File 'lib/view_component/preview.rb', line 12 def render(component, **args, &block) { args: args, block: block, component: component, locals: {}, template: "view_components/preview" } end |
#render_with_template(template: nil, locals: {}) ⇒ Object
22 23 24 25 26 27 |
# File 'lib/view_component/preview.rb', line 22 def render_with_template(template: nil, locals: {}) { template: template, locals: locals } end |