Class: Ramaze::Gestalt

Inherits:

Object

• Object
• Ramaze::Gestalt

show all

Defined in:

lib/ramaze/gestalt.rb

Overview

html =
  Gestalt.build do
    html do
      head do
        title "Hello, World!"
      end
      body do
        h1 "Hello, World!"
      end
    end
  end

Instance Attribute Summary (collapse)

• - (Object) out

  Returns the value of attribute out.

Class Method Summary (collapse)

• + (Object) build(&block)

  The default way to start building your markup.

Instance Method Summary (collapse)

• - (Object) _gestalt_build_tag(name, attr = {}, text = [])

  Build a tag for name, using args and an optional block that will be yielded.

• - (Object) _gestalt_call_tag(name, args, &block)

  Calls a particular tag based on the specified parameters.

• - (Object) _gestalt_escape_entities(s)

  Replace common HTML characters such as " and < with their entities.

• - (Gestalt) initialize(&block) constructor

  Gestalt.new is like ::build but will return itself.

• - (Object) method_missing(meth, *args, &block)

  Catching all the tags.

• - (Object) p(*args, &block)

  Workaround for Kernel#p to make tags possible.

• - (Object) select(*args, &block)

  Workaround for Kernel#select to make work.

• - (Object) tag(name, *args, &block)

  Shortcut for building tags,.

• - (String) to_s (also: #to_str)

  Convert the final output of Gestalt to a string.

44
45
46
47

# File 'lib/ramaze/gestalt.rb', line 44

def initialize(&block)
  @out = []
  instance_eval(&block) if block_given?
end

56
57
58

# File 'lib/ramaze/gestalt.rb', line 56

def method_missing(meth, *args, &block)
  _gestalt_call_tag meth, args, &block
end

23
24
25

# File 'lib/ramaze/gestalt.rb', line 23

def out
  @out
end

31
32
33

# File 'lib/ramaze/gestalt.rb', line 31

def self.build(&block)
  self.new(&block).to_s
end

110
111
112
113
114
115
116
117
118
119
120
121
122
123
124

# File 'lib/ramaze/gestalt.rb', line 110

def _gestalt_build_tag(name, attr = {}, text = [])
  @out << "<#{name}"
  @out << attr.map{|(k,v)| %[ #{k}="#{_gestalt_escape_entities(v)}"] }.join
  if text != [] or block_given?
    @out << ">"
    @out << _gestalt_escape_entities([text].join)
    if block_given?
      text = yield
      @out << text.to_str if text != @out and text.respond_to?(:to_str)
    end
    @out << "</#{name}>"
  else
    @out << ' />'
  end
end

89
90
91
92
93
94
95
96
97
98
99
100

# File 'lib/ramaze/gestalt.rb', line 89

def _gestalt_call_tag(name, args, &block)
  if args.size == 1 and args[0].kind_of? Hash
    # args are just attributes, children in block...
    _gestalt_build_tag name, args[0], &block
  elsif args[1].kind_of? Hash
    # args are text and attributes ie. a('mylink', :href => '/mylink')
    _gestalt_build_tag(name, args[1], args[0], &block)
  else
    # no attributes, but text
    _gestalt_build_tag name, {}, args, &block
  end
end

131
132
133
134
135
136
137

# File 'lib/ramaze/gestalt.rb', line 131

def _gestalt_escape_entities(s)
  s.to_s.gsub(/&/, '&').
    gsub(/"/, '"').
    gsub(/'/, ''').
    gsub(/</, '&lt;').
    gsub(/>/, '&gt;')
end

67
68
69

# File 'lib/ramaze/gestalt.rb', line 67

def p(*args, &block)
  _gestalt_call_tag :p, args, &block
end

78
79
80

# File 'lib/ramaze/gestalt.rb', line 78

def select(*args, &block)
  _gestalt_call_tag(:select, args, &block)
end

146
147
148

# File 'lib/ramaze/gestalt.rb', line 146

def tag(name, *args, &block)
  _gestalt_call_tag(name.to_s, args, &block)
end

156
157
158

# File 'lib/ramaze/gestalt.rb', line 156

def to_s
  @out.join
end