SimpleDisplay

Showcase your Rails models easily.

SimpleDisplay aims to provide a flexible way to display your model attribute and methods, so you can move from this:

<dl>
  <% if @book.title.present? %>
    <dt>Title</dt>
    <dd><%= @book.title %></dd>
  <% end %>

  <% if @book.price.present? %>
    <dt>Price</dt>
    <dd><%= number_with_currency @book.price %></dd>
  <% end %>
</dl>

To this:

<%= display_for @book do |d| %>
  <dl>
    <%= d.display :title %>
    <%= d.currency :price %>
  </dl>
<% end %>

This gem was inspired by this post by Ben West in the Quick Left blog. Thank you! <3

Installation

Add this line to your application's Gemfile:

gem 'simple_display', github: 'mrcasals/simple_display'

And then execute:

$ bundle

Or install it with:

$ gem install simple_display --pre

Usage

Simply install simple_display and start using it:

<%= display_for @book do |d| %>
  <dl>
    <%= d.display :title %>
    <%= d.currency :price %>
  </dl>
<% end %>

Custom displayers

You can use custom displayers. Create an app/displayers folder in your Rails app and add your displayers there. For instance, if you want to create an displayer that parses a text as markdown and outputs it as HTML using the Kramdown gem, you could do this:

# app/displayers/markdown_displayer.rb
class MarkdownDisplayer < SimpleDisplay::Displayers:Base
  def display_value(field_value, &block)
    Kramdown::Document.new(field_value).to_html.html_safe
  end
end

TODO

Add tests & docs (sorry!)
Add more displayers
Add more content to this README file

Contributing