Class: Inversion::Template::UnlessTag

Inherits:
AttrTag show all
Includes:
ContainerTag
Defined in:
lib/inversion/template/unlesstag.rb

Overview

Inversion ‘unless’ tag.

This tag causes a section of the template to be rendered only if its methodchain or attribute is a false value.

Syntax

<?unless attr ?>...<?end?>
<?unless obj.method ?>...<?end?>

Constant Summary

Constants inherited from Tag

Tag::TAG_PLUGIN_PATTERN

Instance Attribute Summary collapse

Attributes included from ContainerTag

#subnodes

Attributes inherited from AttrTag

#format, #methodchain, #name

Attributes inherited from CodeTag

#body, #identifiers

Attributes inherited from Tag

#body

Attributes inherited from Node

#colnum, #linenum

Instance Method Summary collapse

Methods included from ContainerTag

#<<, #is_container?, #render_subnodes

Methods inherited from AttrTag

#as_comment_body, #evaluate

Methods inherited from CodeTag

inherit_tag_patterns, tag_pattern, tag_patterns

Methods included from AbstractClass

included

Methods included from AbstractClass::ClassMethods

#inherited, #pure_virtual

Methods inherited from Tag

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

Methods included from MethodUtilities

#singleton_attr_accessor, #singleton_attr_reader, #singleton_attr_writer

Methods inherited from Node

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

Constructor Details

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

Create a new UnlessTag.



41
42
43
44
 
# File 'lib/inversion/template/unlesstag.rb', line 41

def initialize( body, linenum=nil, colnum=nil )
  @inverted = false
  super
end

Instance Attribute Details

#inverted ⇒ Object

Invert the tag’s renderstate if created with the ‘not’ operator.



47
48
49
 
# File 'lib/inversion/template/unlesstag.rb', line 47

def inverted
  @inverted
end

Instance Method Details

#render(state) ⇒ Object

Render the tag’s contents if the condition is true, or any else or elsif sections if the condition isn’t true.



52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
 
# File 'lib/inversion/template/unlesstag.rb', line 52

def render( state )

  evaluated_state = self.evaluate( state )
  evaluated_state = ! evaluated_state if self.inverted

  # Start out with rendering *disabled* if the tag body evaluates trueishly
  if evaluated_state
    self.log.debug "Initial state was TRUE; disabling rendering"
    state.disable_rendering
  else
    self.log.debug "Initial state was FALSE; enabling rendering"
    state.enable_rendering
  end

  # Set the tag state to track whether or not rendering has been enabled during the
  # 'unless' for an 'else' tag.
  state.with_tag_data( :rendering_was_enabled => state.rendering_enabled? ) do
    self.render_subnodes( state )
  end

  state.enable_rendering
  return nil
end