Class: Sass::Tree::PropNode

Inherits:
Node
  • Object
show all
Defined in:
lib/sass/tree/prop_node.rb

Overview

A static node representing a CSS property.

See Also:

Instance Attribute Summary collapse

Attributes inherited from Node

#children, #filename, #has_children, #line, #options, #source_range

Instance Method Summary collapse

Methods inherited from Node

#<<, #balance, #bubbles?, #css, #css_with_sourcemap, #deep_copy, #each, #inspect, #style, #to_sass, #to_scss

Constructor Details

#initialize(name, value, prop_syntax) ⇒ PropNode

Returns a new instance of PropNode

Parameters:


59
60
61
62
63
64
65
66
# File 'lib/sass/tree/prop_node.rb', line 59

def initialize(name, value, prop_syntax)
  @name = Sass::Util.strip_string_array(
    Sass::Util.merge_adjacent_strings(name))
  @value = value
  @tabs = 0
  @prop_syntax = prop_syntax
  super()
end

Instance Attribute Details

#nameArray<String, Sass::Script::Tree::Node>

The name of the property, interspersed with Script::Tree::Nodes representing #{}-interpolation. Any adjacent strings will be merged together.

Returns:


12
13
14
# File 'lib/sass/tree/prop_node.rb', line 12

def name
  @name
end

#name_source_rangeSass::Source::Range

The source range in which the property name appears.

Returns:


48
49
50
# File 'lib/sass/tree/prop_node.rb', line 48

def name_source_range
  @name_source_range
end

#resolved_nameString

The name of the property after any interpolated SassScript has been resolved. Only set once Visitors::Perform has been run.

Returns:

  • (String)

19
20
21
# File 'lib/sass/tree/prop_node.rb', line 19

def resolved_name
  @resolved_name
end

#resolved_valueString

The value of the property after any interpolated SassScript has been resolved. Only set once Visitors::Perform has been run.

Returns:

  • (String)

31
32
33
# File 'lib/sass/tree/prop_node.rb', line 31

def resolved_value
  @resolved_value
end

#tabsFixnum

How deep this property is indented relative to a normal property. This is only greater than 0 in the case that:

  • This node is in a CSS tree
  • The style is :nested
  • This is a child property of another property
  • The parent property has a value, and thus will be rendered

Returns:

  • (Fixnum)

43
44
45
# File 'lib/sass/tree/prop_node.rb', line 43

def tabs
  @tabs
end

#valueSass::Script::Tree::Node

The value of the property.


24
25
26
# File 'lib/sass/tree/prop_node.rb', line 24

def value
  @value
end

#value_source_rangeSass::Source::Range

The source range in which the property value appears.

Returns:


53
54
55
# File 'lib/sass/tree/prop_node.rb', line 53

def value_source_range
  @value_source_range
end

Instance Method Details

#==(other) ⇒ Boolean

Compares the names and values of two properties.

Parameters:

  • other (Object)

    The object to compare with

Returns:

  • (Boolean)

    Whether or not this node and the other object are the same


73
74
75
# File 'lib/sass/tree/prop_node.rb', line 73

def ==(other)
  self.class == other.class && name == other.name && value == other.value && super
end

#declaration(opts = {:old => @prop_syntax == :old}, fmt = :sass)

Computes the Sass or SCSS code for the variable declaration. This is like Node#to_scss or Node#to_sass, except it doesn't print any child properties or a trailing semicolon.

Parameters:

  • opts ({Symbol => Object}) (defaults to: {:old => @prop_syntax == :old})

    The options hash for the tree.

  • fmt (Symbol) (defaults to: :sass)

    :scss or :sass.


99
100
101
102
103
104
105
106
107
108
109
110
# File 'lib/sass/tree/prop_node.rb', line 99

def declaration(opts = {:old => @prop_syntax == :old}, fmt = :sass)
  name = self.name.map {|n| n.is_a?(String) ? n : n.to_sass(opts)}.join
  if name[0] == ?:
    raise Sass::SyntaxError.new("The \"#{name}: #{self.class.val_to_sass(value, opts)}\"" +
                                " hack is not allowed in the Sass indented syntax")
  end

  old = opts[:old] && fmt == :sass
  initial = old ? ':' : ''
  mid = old ? '' : ':'
  "#{initial}#{name}#{mid} #{self.class.val_to_sass(value, opts)}".rstrip
end

#invisible?Boolean

A property node is invisible if its value is empty.

Returns:

  • (Boolean)

115
116
117
# File 'lib/sass/tree/prop_node.rb', line 115

def invisible?
  resolved_value.empty?
end

#pseudo_class_selector_messageString

Returns a appropriate message indicating how to escape pseudo-class selectors. This only applies for old-style properties with no value, so returns the empty string if this is new-style.

Returns:

  • (String)

    The message


82
83
84
85
86
87
88
89
90
91
# File 'lib/sass/tree/prop_node.rb', line 82

def pseudo_class_selector_message
  if @prop_syntax == :new ||
      !value.is_a?(Sass::Script::Tree::Literal) ||
      !value.value.is_a?(Sass::Script::Value::String) ||
      !value.value.value.empty?
    return ""
  end

  "\nIf #{declaration.dump} should be a selector, use \"\\#{declaration}\" instead."
end