Formie

Tired of programming each HTML tag? Are you in search of DRYness for Rails views? May be Formie can help you.

Formie implements low level template-based helpers. It injects the formies into the ActionView module. The form-bounded as well as the unbounded templates are supported. Still, the ActionView functionality (e.g. text_field) is kept untouched. In short, Formie is like a helper using the notation of a partial.

Templates handlers are supported as in partials.

As usual:

# Gemfile
gem "formie"

and run "bundle install".

Templates for Formie are hosted in:

• <formie_path>/forms (bounded to form)
• <formie_path>/application (free standing)
• <formie_path>/templates (free standing)

Till Rails 5 <formie_path> is 'app/formies'. Starting at Rails 6 <formie_path> is 'app/views/formies'.

Version 1.1.0+ is intended for Rails 7

Inside a formie the following locals (as delivered by the controller) are available:

Locals are passed in a hash. The controller attributes are available as usual.

To avoid a server restart during development of formies you may add to:

# app/controllers/application_controller.rb

before_filter do
  Formie.reload  if Rails.env.development?
end

<%= copyright %>
<%= back %>
<%= show obj: @order %>

<%= form_with model: Order do |f| %>
  <%= f.l_text_field :who %>
  <%= f.l_text_field :amount %>
<% end %>

In directory <formie_path> :

# application/copyright.html.erb
<div class="copyright"> Copyright (c) 2009 </div>

# application/back.html.erb
<a href="<%= "/#{h(controller_name)}" %>"> Back </a>

# application/show.html.erb
<a href="<%= "/#{h(controller_name)}/#{obj.id}" %>"> Show </a>

# forms/l_text_field.html.erb
<% field = args.first %>
<p>
  <%= form.label field %><br />
  <%= form.text_field field %>
</p>

# templates/hello.slim
/ a comment

span Hello Slim

Copyright (c) 2009-2024 Dittmar Krall (www.matiq.com), released under the MIT license.