Class: ViewComponent::Config

Inherits:
Object
  • Object
show all
Defined in:
lib/view_component/config.rb

Class Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize ⇒ Config

Returns a new instance of Config.



170
171
172
 
# File 'lib/view_component/config.rb', line 170

def initialize
  @config = self.class.defaults
end

Class Attribute Details

.capture_compatibility_patch_enabled ⇒ Boolean

Enables the experimental capture compatibility patch that makes ViewComponent compatible with forms, capture, and other built-ins. previews. Defaults to ‘false`.

Returns:

  • (Boolean) 


157
158
159
160
161
 
# File 'lib/view_component/config.rb', line 157

def default_preview_paths
  return [] unless defined?(Rails.root) && Dir.exist?("#{Rails.root}/test/components/previews")

  ["#{Rails.root}/test/components/previews"]
end

.component_parent_class ⇒ String

The parent class from which generated components will inherit. Defaults to ‘nil`. If this is falsy, generators will use `“ApplicationComponent”` if defined, `“ViewComponent::Base”` otherwise.

Returns:

  • (String) 



# File 'lib/view_component/config.rb', line 122

.default_preview_layout ⇒ String

A custom default layout used for the previews index page and individual previews. Defaults to ‘nil`. If this is falsy, `“component_preview”` is used.

Returns:

  • (String) 



# File 'lib/view_component/config.rb', line 144

.generate ⇒ ActiveSupport::OrderedOptions

The subset of configuration options relating to generators.

All options under this namespace default to ‘false` unless otherwise stated.

#### ‘#sidecar`

Always generate a component with a sidecar directory:

config.view_component.generate.sidecar = true

#### ‘#stimulus_controller`

Always generate a Stimulus controller alongside the component:

config.view_component.generate.stimulus_controller = true

#### ‘#locale`

Always generate translations file alongside the component:

config.view_component.generate.locale = true

#### ‘#distinct_locale_files`

Always generate as many translations files as available locales:

config.view_component.generate.distinct_locale_files = true

One file will be generated for each configured ‘I18n.available_locales`, falling back to `[:en]` when no `available_locales` is defined.

#### ‘#preview`

Always generate a preview alongside the component:

config.view_component.generate.preview = true

#### #preview_path

Path to generate preview:

config.view_component.generate.preview_path = "test/components/previews"

Required when there is more than one path defined in preview_paths. Defaults to ‘“”`. If this is blank, the generator will use `ViewComponent.config.preview_paths` if defined, `“test/components/previews”` otherwise

Returns:

  • (ActiveSupport::OrderedOptions) 



# File 'lib/view_component/config.rb', line 32

.instrumentation_enabled ⇒ Boolean

Whether ActiveSupport notifications are enabled. Defaults to ‘false`.

Returns:

  • (Boolean) 



# File 'lib/view_component/config.rb', line 98

.preview_controller ⇒ String

The controller used for previewing components. Defaults to ‘ViewComponentsController`.

Returns:

  • (String) 



# File 'lib/view_component/config.rb', line 83

.preview_paths ⇒ Array<String>

The locations in which component previews will be looked up. Defaults to ‘[’test/component/previews’]‘ relative to your Rails root.

Returns:

  • (Array<String>) 



# File 'lib/view_component/config.rb', line 133

.preview_route ⇒ String

The entry route for component previews. Defaults to ‘“/rails/view_components”`.

Returns:

  • (String) 



# File 'lib/view_component/config.rb', line 88

.render_monkey_patch_enabled ⇒ Boolean

If this is disabled, use ‘#render_component` or `#render_component_to_string` instead. Defaults to `true`.

Returns:

  • (Boolean) —

    Whether the #render method should be monkey patched.




# File 'lib/view_component/config.rb', line 110

.show_previews ⇒ Boolean

Whether component previews are enabled. Defaults to ‘true` in development and test environments.

Returns:

  • (Boolean) 



# File 'lib/view_component/config.rb', line 128

.show_previews_source ⇒ Boolean

Whether to display source code previews in component previews. Defaults to ‘false`.

Returns:

  • (Boolean) 



# File 'lib/view_component/config.rb', line 93

.test_controller ⇒ String

The controller used for testing components. Can also be configured on a per-test basis using ‘#with_controller_class`. Defaults to `ApplicationController`.

Returns:

  • (String) 



# File 'lib/view_component/config.rb', line 138

.use_deprecated_instrumentation_name ⇒ Boolean

Whether ActiveSupport Notifications use the private name ‘“!render.view_component”` or are made more publicly available via `“render.view_component”`. Will default to `false` in next major version. Defaults to `true`.

Returns:

  • (Boolean) 



# File 'lib/view_component/config.rb', line 103

.view_component_path ⇒ String

The path in which components, their templates, and their sidecars should be stored. Defaults to ‘“app/components”`.

Returns:

  • (String) 



# File 'lib/view_component/config.rb', line 116

Class Method Details

.default_generate_options ⇒ Object 



163
164
165
166
167
 
# File 'lib/view_component/config.rb', line 163

def default_generate_options
  options = ActiveSupport::OrderedOptions.new(false)
  options.preview_path = ""
  options
end

.default_preview_paths ⇒ Boolean

Enables the experimental capture compatibility patch that makes ViewComponent compatible with forms, capture, and other built-ins. previews. Defaults to ‘false`.

Returns:

  • (Boolean) 


157
158
159
160
161
 
# File 'lib/view_component/config.rb', line 157

def default_preview_paths
  return [] unless defined?(Rails.root) && Dir.exist?("#{Rails.root}/test/components/previews")

  ["#{Rails.root}/test/components/previews"]
end

.defaults ⇒ Object 



13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
 
# File 'lib/view_component/config.rb', line 13

def defaults
  ActiveSupport::OrderedOptions.new.merge!({
    generate: default_generate_options,
    preview_controller: "ViewComponentsController",
    preview_route: "/rails/view_components",
    show_previews_source: false,
    instrumentation_enabled: false,
    use_deprecated_instrumentation_name: true,
    render_monkey_patch_enabled: true,
    view_component_path: "app/components",
    component_parent_class: nil,
    show_previews: Rails.env.development? || Rails.env.test?,
    preview_paths: default_preview_paths,
    test_controller: "ApplicationController",
    default_preview_layout: nil,
    capture_compatibility_patch_enabled: false
  })
end