Project

cells-erb

0.05
No commit activity in last 3 years
No release in over 3 years
There's a lot of open issues
Tilt binding for Erbse. Erbse is a modern Erubis implementation with block support.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
 Dependencies

Development

>= 0

Runtime

~> 4.0
>= 0.1.1
 Project Readme

Cells::Erb

ERB support for Cells using Erbse.

Installation

Add this line to your application's Gemfile:

gem 'cells-erb'

This will register Erbse::Engine with Tilt for .erb files.

And that's all you need to do.

Erbse

Erbse is the next-generation implementation of ERB that comes with some nice new semantics and explicit code. It does not use instance variables for output buffering.

You should read its docs to learn what you can and can't do with Erbse.

Block Yielding

With Erbse, you can actually capture blocks, pass them to other cells and yield them. This will simply return whatever the block returns, no weird buffer magic will be happening in the background.

Capture

The capture implementation in Cells-ERB is literally a yield.

def capture(&block)
  yield
end

If you want to capture a block of code without outputting it, you need to use Erbse's <%@ %> tag.

<%@ content = capture do %>
  <h1>Hi!</h1>
  It's <%= Time.new %>'o clock.
<% end %>

The content variable will now contain the string <h1>Hi!</h1>\nIt's 23:37'o clock..

Use c@pture as a mnemonic for the correct tag, should you need this mechanic. capture is usually a smell of bad view design and should be avoided.

HTML Escaping

Cells doesn't escape except when you tell it to do. However, you may run into problems when using Rails helpers. Internally, those helpers often blindly escape. This is not Cells' fault but a design flaw in Rails.

As a first step, try this and see if it helps.

class SongCell < Cell::ViewModelERB
  include ActionView::Helpers::FormHelper
  # ..
end

If that doesn't work, read the docs.

Dependencies

This gem works with Tilt 1.4 and 2.0, and hence allows you to use it from Rails 3.2 upwards.