1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
|
---
layout: default
title: Compatibility
nav_order: 6
---
# Compatibility
## Ruby & Rails
ViewComponent is [supported natively](https://edgeguides.rubyonrails.org/layouts_and_rendering.html#rendering-objects) in Rails 6.1, and compatible with Rails 5.0+ via an included [monkey patch](https://github.com/viewcomponent/view_component/blob/main/lib/view_component/render_monkey_patch.rb).
ViewComponent is tested for compatibility [with combinations of](https://github.com/viewcomponent/view_component/blob/22e3d4ccce70d8f32c7375e5a5ccc3f70b22a703/.github/workflows/ruby_on_rails.yml#L10-L11) Ruby v2.5+ and Rails v5+. Ruby 2.4 is likely compatible, but is no longer tested.
## Template languages
ViewComponent is tested against ERB, Haml, and Slim, but it should support most Rails template handlers.
## Disabling the render monkey patch (Rails < 6.1)
Since 2.13.0
{: .label }
To [avoid conflicts](https://github.com/viewcomponent/view_component/issues/288) between ViewComponent and other gems that also monkey patch the `render` method, it's possible to configure ViewComponent to not include the render monkey patch:
`config.view_component.render_monkey_patch_enabled = false # defaults to true`
With the monkey patch disabled, use `render_component` (or `render_component_to_string`) instead:
```erb
<%= render_component Component.new(message: "bar") %>
```
## Bridgetown (Static Site Generator)
[Bridgetown](https://www.bridgetownrb.com/) supports ViewComponent via an experimental shim provided by the [bridgetown-view-component gem](https://github.com/bridgetownrb/bridgetown-view-component). More information available [here](https://www.bridgetownrb.com/docs/components/ruby#need-compatibility-with-rails-try-viewcomponent-experimental).
## ActionText
Using `rich_text_area` from ActionText in a ViewComponent will result in this error:
```ruby
undefined method 'rich_text_area_tag'
```
This is due to ViewComponent not having access to the helpers it needs via ActionText. As a workaround, add the following to your component (or base component):
```ruby
delegate :rich_text_area_tag, to: :helpers
```
|
