1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
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
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
|
module Sass::Tree
# A static node representing a CSS property.
#
# @see Sass::Tree
class PropNode < Node
# The name of the property,
# interspersed with {Sass::Script::Tree::Node}s
# representing `#{}`-interpolation.
# Any adjacent strings will be merged together.
#
# @return [Array<String, Sass::Script::Tree::Node>]
attr_accessor :name
# The name of the property
# after any interpolated SassScript has been resolved.
# Only set once \{Tree::Visitors::Perform} has been run.
#
# @return [String]
attr_accessor :resolved_name
# The value of the property.
#
# For most properties, this will just contain a single Node. However, for
# CSS variables, it will contain multiple strings and nodes representing
# interpolation. Any adjacent strings will be merged together.
#
# @return [Array<String, Sass::Script::Tree::Node>]
attr_accessor :value
# The value of the property
# after any interpolated SassScript has been resolved.
# Only set once \{Tree::Visitors::Perform} has been run.
#
# @return [String]
attr_accessor :resolved_value
# 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
#
# @return [Integer]
attr_accessor :tabs
# The source range in which the property name appears.
#
# @return [Sass::Source::Range]
attr_accessor :name_source_range
# The source range in which the property value appears.
#
# @return [Sass::Source::Range]
attr_accessor :value_source_range
# Whether this represents a CSS custom property.
#
# @return [Boolean]
def custom_property?
name.first.is_a?(String) && name.first.start_with?("--")
end
# @param name [Array<String, Sass::Script::Tree::Node>] See \{#name}
# @param value [Array<String, Sass::Script::Tree::Node>] See \{#value}
# @param prop_syntax [Symbol] `:new` if this property uses `a: b`-style syntax,
# `:old` if it uses `:a b`-style syntax
def initialize(name, value, prop_syntax)
@name = Sass::Util.strip_string_array(
Sass::Util.merge_adjacent_strings(name))
@value = Sass::Util.merge_adjacent_strings(value)
@value = Sass::Util.strip_string_array(@value) unless custom_property?
@tabs = 0
@prop_syntax = prop_syntax
super()
end
# Compares the names and values of two properties.
#
# @param other [Object] The object to compare with
# @return [Boolean] Whether or not this node and the other object
# are the same
def ==(other)
self.class == other.class && name == other.name && value == other.value && super
end
# 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.
#
# @return [String] The message
def pseudo_class_selector_message
if @prop_syntax == :new ||
custom_property? ||
!value.first.is_a?(Sass::Script::Tree::Literal) ||
!value.first.value.is_a?(Sass::Script::Value::String) ||
!value.first.value.value.empty?
return ""
end
"\nIf #{declaration.dump} should be a selector, use \"\\#{declaration}\" instead."
end
# Computes the Sass or SCSS code for the variable declaration.
# This is like \{#to\_scss} or \{#to\_sass},
# except it doesn't print any child properties or a trailing semicolon.
#
# @param opts [{Symbol => Object}] The options hash for the tree.
# @param fmt [Symbol] `:scss` or `:sass`.
def declaration(opts = {:old => @prop_syntax == :old}, fmt = :sass)
name = self.name.map {|n| n.is_a?(String) ? n : n.to_sass(opts)}.join
value = self.value.map {|n| n.is_a?(String) ? n : n.to_sass(opts)}.join
value = "(#{value})" if value_needs_parens?
if name[0] == ?:
raise Sass::SyntaxError.new("The \"#{name}: #{value}\"" +
" hack is not allowed in the Sass indented syntax")
end
# The indented syntax doesn't support newlines in custom property values,
# but we can losslessly convert them to spaces instead.
value = value.tr("\n", " ") if fmt == :sass
old = opts[:old] && fmt == :sass
"#{old ? ':' : ''}#{name}#{old ? '' : ':'}#{custom_property? ? '' : ' '}#{value}".rstrip
end
# A property node is invisible if its value is empty.
#
# @return [Boolean]
def invisible?
!custom_property? && resolved_value.empty?
end
private
# Returns whether \{#value} neesd parentheses in order to be parsed
# properly as division.
def value_needs_parens?
return false if custom_property?
root = value.first
root.is_a?(Sass::Script::Tree::Operation) &&
root.operator == :div &&
root.operand1.is_a?(Sass::Script::Tree::Literal) &&
root.operand1.value.is_a?(Sass::Script::Value::Number) &&
root.operand1.value.original.nil? &&
root.operand2.is_a?(Sass::Script::Tree::Literal) &&
root.operand2.value.is_a?(Sass::Script::Value::Number) &&
root.operand2.value.original.nil?
end
def check!
return unless @options[:property_syntax] && @options[:property_syntax] != @prop_syntax
raise Sass::SyntaxError.new(
"Illegal property syntax: can't use #{@prop_syntax} syntax when " +
":property_syntax => #{@options[:property_syntax].inspect} is set.")
end
end
end
|
