Mab let's you write HTML in plain Ruby:
doctype!
html do
head do
link :rel => 'stylesheet', :href => 'style.css'
script :src => 'jquery.js'
end
body :id => :frontpage do
h1 'Hello World', :class => :main
end
endThere are four basic forms:
tagname(content)
tagname(content, attributes)
tagname do
content
end
tagname(attributes) do
content
endExample:
doctype!
html do
head do
link :rel => 'stylesheet', :href => 'style.css'
script :src => 'jquery.js'
end
body :id => :frontpage do
h1 'Hello World', :class => :main
end
endWhich results in:
<!DOCTYPE html>
<html>
<head>
<link rel="stylesheet" href="style.css">
<script src="jquery"></script>
</head>
<body id="frontpage">
<h1 class="main">Hello World</h1>
</body>
</html>Notice how Mab knows that script tag must have content, so although you didn't specify anything it closed the tag for you.
You can easily add classes and IDs by hooking methods onto the container:
body.frontpage! do
h1.main 'Hello World'
endWhich results in:
<body id="frontpage">
<h1 class="main">Hello World</h1>
</body>You can mix and match as you'd like (div.klass.klass1.id!), but you can only
provide content and attributes on the last call:
# This is not valid:
form(:action => :post).world do
input
end
# But this is:
form.world(:action => :post) do
input
endMab uses a very simple convention for escaping: Strings as arguments gets escaped, strings in blocks don't:
div.comment "<script>alert(1)</script>"
# <div class="comment"><script>alert(1)</script></div>
div.comment { "I <strong>love</strong> you" }
# <div class="comment">I <strong>love</strong> you</div>Be aware that Mab ignores the string in a block if there's other tags there:
div.comment do
div.author "BitPuffin"
"<p>Silence!</p>"
endThe p tag above won't appear in the output.
Sometimes you need to insert plain text:
p.author do
text 'Written by '
a 'Bluebie', :href => 'http://creativepony.com/'
endWhich results in:
<p class="author">
Written by
<a href="http://creativepony.com/">Bluebie</a>
</p>There's also text! which doesn't escape:
p.author do
text! '<strong>Written</strong> by'
a 'Bluebie', :href => 'http://creativepony.com/'Using #mab:
require 'mab/kernel_method'
str = mab do
doctype!
html do
# ...
end
endUsing Mab::Builder (or Mab::PrettyBuilder if you want indentation):
class Person
attr_reader :name
def initialize(name)
@name = name
end
def awesome?; true end
end
# Assign instance variables:
Mab::Builder.new(:person => Person.new('BitBuffin')) do
if @person.awesome?
h1 @person.name
else
p @person.name
end
end.to_s
# Use helper (methods and instance variables will be available):
Mab::Builder.new({}, Person.new('BitPuffin')) do
if awesome?
h1 @name
else
p @name
end
end.to_sExtending an object (advanced usage):
r = Object.new
r.extend Mab::Mixin::HTML5
r.extend Mab::Indentation
r.mab do
doctype!
html do
# ...
end
end