LocastyleComponents

Gem contendo helpers para construção de componentes do locastyle em templates ERB.

Installation

Add this line to your application's Gemfile:

gem 'locastyle_components'

And then execute:

$ bundle

Componentes Disponíveis

Por ser uma versão inicial, essa gem contempla somente alguns componentes, podendo não atender alguns casos específicos.

Componentes de Formulário

• Botão Switch Ver original

Componentes Comuns

• Collapse Ver original

Usage

Componentes de Formulário

Para usar os componentes de formulário é necessário que sejam chamados dentro de um bloco form do rails (form_for):

<%= form_for(:user) do |f| %>
  <%= f.gem_component_here(options) %>
<% end %>

Botão Switch

Parâmetros:

• Atributo a ser controlad
• Hash de argumentos (:label)

# Usando nome do atributo como label
<%= f.locastyle_switch_button(:status) %>

# Usando uma label customizada
<%= f.locastyle_switch_button(:status, label: 'Custom') %>

# Sem label
<%= f.locastyle_switch_button(:default, label: false) %>

Componentes Comuns

Esses componentes podem ser chamados em qualquer ponto da view.

Collapse

Parâmetros:

• Hash de argumentos (:title)
• Bloco com o conteúdo

Recebe um Hash como parâmetro e no momento utiliza somente a chave :title. O conteúdo deve ser passado em um bloco.

  <% content_for :collapse_header do %>
    <h1 class="ls-collapse-title">Title</h1>
    <p>Subtitle</p>
  <% end %>

  <%= locastyle_collapse_tag({ title: yield(:collapse_header) }) do %>
    <p>Content</p>
  <% end %>

  <%= locastyle_collapse_tag({ title: some_helper }) do %>
    <p>Content</p>
  <% end %>

  <%= locastyle_collapse_tag(some_helper) do %>
    content_helper
  <% end %>

  <%= locastyle_collapse_tag(some_helper) do %>
    <p>Content</p>
  <% end %>

  <%= locastyle_collapse_tag({ title: I18n.t('key') }) do %>
    <p>Content</p>
  <% end %>

Development

Ao realizar alguma alteração, lembre-se de manter o que já tinha funcionando. Escreva casos de testes sempre que possível.