Matestack Ui Core
AboutMatestack Ui CoreMatestack Ui VueJsMatestack Ui Bootstrap
3.0
3.0
  • Welcome
  • Migrating from 2.x to 3.0
  • Getting started
    • Installation & Update
    • Hello World
  • HTML Rendering
    • Basic Rendering Mechanism
    • Integrating Action View Helpers
    • Integrating Rails Views or Partials
  • Components
    • API
    • Usage on Rails Views
    • Usage on Matestack Pages
    • Usage on Matestack Layouts
    • Usage in Isolation
    • Registry
  • Pages
    • API
    • Rails Controller Integration
  • Layouts
    • API
    • Rails Controller Integration
Powered by GitBook
On this page

Was this helpful?

Edit on GitHub
  1. Components

Registry

By default, components can be called directly like Components::Card.call(title: "foo", body: "bar") which will return the desired HTML string.

If desired, you can create alias methods in order to avoid the class call syntax:

app/matestack/components/registry.rb
module Components::Registry

  def card(text=nil, options=nil, &block)
    Components::Card.call(text, options, &block)
  end

  #...

end

which then allows you to call the card component like card(title: "foo", body: "bar") if the above shown module is included properly.

As this is just a plain Ruby module, you need to include it in all contexts you want to use the alias method. It might be a good idea to create your own ApplicationPage, ApplicationComponent and ApplicationLayout as base classes for your pages, components ans layouts. In there, you include your component registry module(s) only once and have access to the alias methods in all child classes:

app/matestack/application_page.rb
class ApplicationPage < Matestack::Ui::Page

  include Components::Registry

end
app/matestack/application_component.rb
class ApplicationComponent < Matestack::Ui::Component

  include Components::Registry

end
app/matestack/application_layout.rb
class ApplicationLayout < Matestack::Ui::Layout

  include Components::Registry

end
PreviousUsage in IsolationNextAPI

Last updated 3 years ago

Was this helpful?