Class: Inversion::Template::ImportTag

Inherits:
Tag
  • Object
show all
Defined in:
lib/inversion/template/importtag.rb

Overview

Inversion import tag.

The import tag copies one or more attributes from an enclosing template so they only need to be set once.

Syntax

<?import txn ?>
<?import foo, bar ?>

Constant Summary

Constants inherited from Tag

Tag::TAG_PLUGIN_PATTERN

Instance Attribute Summary collapse

Attributes inherited from Tag

#body

Attributes inherited from Node

#colnum, #linenum

Instance Method Summary collapse

Methods inherited from Tag

create, #derivatives, inherited, load, load_all, #tagname, types, #types

Methods included from MethodUtilities

#singleton_attr_accessor, #singleton_attr_reader, #singleton_attr_writer

Methods included from AbstractClass

included

Methods included from AbstractClass::ClassMethods

#inherited, #pure_virtual

Methods inherited from Node

#after_appending, #after_rendering, #before_appending, #before_rendering, #is_container?, #location

Constructor Details

#initialize(body, linenum = nil, colnum = nil) ⇒ ImportTag

Create a new ImportTag with the given ‘name`, which should be a valid Ruby identifier.



21
22
23
24
 
# File 'lib/inversion/template/importtag.rb', line 21

def initialize( body, linenum=nil, colnum=nil )
  super
  @attributes = body.split( /\s*,\s*/ ).collect {|name| name.strip.to_sym }
end

Instance Attribute Details

#attributes ⇒ Object (readonly)

the names of the attributes to import



32
33
34
 
# File 'lib/inversion/template/importtag.rb', line 32

def attributes
  @attributes
end

Instance Method Details

#as_comment_body ⇒ Object

Render the tag as the body of a comment, suitable for template debugging.



67
68
69
 
# File 'lib/inversion/template/importtag.rb', line 67

def as_comment_body
  return "Import %s" % [ self.attributes.join(', ') ]
end

#render(renderstate) ⇒ Object

Merge the inherited renderstate into the current template’s ‘renderstate`.



36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
 
# File 'lib/inversion/template/importtag.rb', line 36

def render( renderstate )
  if (( cstate = renderstate.containerstate ))
    # self.log.debug "Importing inherited attributes: %p from %p" %
    # [ @attributes, cstate.attributes ]

    # Pick out the attributes that are being imported
    inherited_attrs = @attributes.inject( {} ) do |attrs, key|
      attrs[ key ] = cstate.attributes[ key ]
      attrs
    end

    # Merge, but overwrite unset values with inherited ones
    renderstate.attributes.merge!( inherited_attrs ) do |key, oldval, newval|
      if oldval.nil?
        # self.log.debug "Importing attribute %p: %p" % [ key, newval ]
        newval
      else
        # self.log.debug "Not importing attribute %p: already set to %p" % [ key, oldval ]
        oldval
      end
    end

  else
    self.log.debug "No-op import: no parent attributes set."
  end

  return nil
end