# Rails View

Use your Rails views or partials with this component in your views, matestack pages, components or apps.

## Parameters

This component expects that either `view` or `partial` is given as parameter.

### view (optional)

Expects a string, specifying the path of the view that should be rendered by the component. The path resolution works like Rails `render 'your_path'` path resolution.

### partial (optional)

Expects a string, specifying the partial that should be rendered by the component. The path resolution works like Rails `render partial: 'your_path'` path resolution.

## Example 1 - Using Rails View and Partial on a page, component or app

```ruby
class WelcomePage < Matestack::Ui::Page
  def response
    rails_view view: 'welcome/header'
    rails_view partial: 'welcome/hero'
    heading text: 'Welcome', size: 1
  end
end
```

The above page will first render your 'welcome/header' view. If for example you use erb templates, it will render your `app/views/welcome/header.html.erb` view. And secondly it will render your 'welcome/hero' partial. Again, if you use erb templates, it will render your `app/views/welcome/_hero.html.erb` partial. The usage of `rails_view` is the same on a page, component or app.

## Example 2 - Using Rails View in a view

You can also use `rails_view` in another view

```markup
<%= matestack_component(:rails_view, view: 'welcome/header') %>
<%= matestack_component(:rails_view, partial: 'welcome/hero') %>
```

## Example 3 - Passing and accessing data

You can access all your instance variables from your controller action within a view or partial rendered by `rails_view`. You can also pass data explicitly. Just add them to the hash you pass to the `rails_view` call. You can access those like you would do if you pass `locals` to a rails view or partial.

Your `rails_view` call:

```ruby
rails_view view: 'welcome/header', headline: 'Great to see you!'
```

and in your rails view you can access your data as follows:

```
<h1><%= headline %></h1>
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.matestack.io/matestack-ui-core/1.5.0/components-api/core-components/rails-view.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.