Class: Sass::Selector::Simple
- Inherits:
-
Object
- Object
- Sass::Selector::Simple
- Defined in:
- lib/sass/selector/simple.rb
Overview
The abstract superclass for simple selectors (that is, those that don't compose multiple selectors).
Direct Known Subclasses
Attribute, Class, Element, Id, Interpolation, Parent, Placeholder, Pseudo, SelectorPseudoClass, Universal
Instance Attribute Summary collapse
-
#filename ⇒ String?
The name of the file in which this selector was declared, or
nil
if it was not declared in a file (e.g. on stdin). -
#line ⇒ Fixnum
The line of the Sass template on which this selector was declared.
Instance Method Summary collapse
-
#eql?(other) ⇒ Boolean
(also: #==)
Checks equality between this and another object.
-
#equality_key ⇒ Array<String, Sass::Script::Tree::Node>
protected
Returns the key used for testing whether selectors are equal.
-
#hash ⇒ Fixnum
Returns a hash code for this selector object.
-
#inspect ⇒ String
Returns a string representation of the node.
-
#to_a ⇒ Array<String, Sass::Script::Tree::Node>
Returns a representation of the node as an array of strings and potentially Sass::Script::Tree::Nodes (if there's interpolation in the selector).
- #to_s ⇒ String
-
#unify(sels) ⇒ Array<Simple>?
Unifies this selector with a SimpleSequence's members array, returning another
SimpleSequence
members array that matches both this selector and the input selector. -
#unify_namespaces(ns1, ns2) ⇒ Array(String or nil, Boolean)
protected
Unifies two namespaces, returning a namespace that works for both of them if possible.
Instance Attribute Details
#filename ⇒ String?
The name of the file in which this selector was declared,
or nil
if it was not declared in a file (e.g. on stdin).
15 16 17 |
# File 'lib/sass/selector/simple.rb', line 15
def filename
@filename
end
|
#line ⇒ Fixnum
The line of the Sass template on which this selector was declared.
9 10 11 |
# File 'lib/sass/selector/simple.rb', line 9
def line
@line
end
|
Instance Method Details
#eql?(other) ⇒ Boolean Also known as: ==
Checks equality between this and another object.
By default, this is based on the value of #to_a, so if that contains information irrelevant to the identity of the selector, this should be overridden.
60 61 62 |
# File 'lib/sass/selector/simple.rb', line 60
def eql?(other)
other.class == self.class && other.hash == hash && other.equality_key.eql?(equality_key)
end
|
#equality_key ⇒ Array<String, Sass::Script::Tree::Node> (protected)
Returns the key used for testing whether selectors are equal.
This is based on #to_a, with adjacent strings merged so that selectors constructed in different ways are considered equivalent.
103 104 105 |
# File 'lib/sass/selector/simple.rb', line 103
def equality_key
@equality_key ||= Sass::Util.merge_adjacent_strings(to_a)
end
|
#hash ⇒ Fixnum
Returns a hash code for this selector object.
By default, this is based on the value of #to_a, so if that contains information irrelevant to the identity of the selector, this should be overridden.
48 49 50 |
# File 'lib/sass/selector/simple.rb', line 48
def hash
@_hash ||= equality_key.hash
end
|
#inspect ⇒ String
Returns a string representation of the node. This is basically the selector string.
31 32 33 |
# File 'lib/sass/selector/simple.rb', line 31
def inspect
to_a.map {|e| e.is_a?(Sass::Script::Tree::Node) ? "\#{#{e.to_sass}}" : e}.join
end
|
#to_a ⇒ Array<String, Sass::Script::Tree::Node>
Returns a representation of the node as an array of strings and potentially Sass::Script::Tree::Nodes (if there's interpolation in the selector). When the interpolation is resolved and the strings are joined together, this will be the string representation of this node.
23 24 25 |
# File 'lib/sass/selector/simple.rb', line 23
def to_a
Sass::Util.abstract(self)
end
|
#to_s ⇒ String
37 38 39 |
# File 'lib/sass/selector/simple.rb', line 37
def to_s
inspect
end
|
#unify(sels) ⇒ Array<Simple>?
Unifies this selector with a Sass::Selector::SimpleSequence's members array,
returning another SimpleSequence
members array
that matches both this selector and the input selector.
By default, this just appends this selector to the end of the array (or returns the original array if this selector already exists in it).
82 83 84 85 86 87 88 89 90 91 92 93 |
# File 'lib/sass/selector/simple.rb', line 82
def unify(sels)
return sels if sels.any? {|sel2| eql?(sel2)}
sels_with_ix = Sass::Util.enum_with_index(sels)
_, i =
if is_a?(Pseudo) || is_a?(SelectorPseudoClass)
sels_with_ix.find {|sel, _| sel.is_a?(Pseudo) && (sels.last.type == :element)}
else
sels_with_ix.find {|sel, _| sel.is_a?(Pseudo) || sel.is_a?(SelectorPseudoClass)}
end
return sels + [self] unless i
sels[0...i] + [self] + sels[i..-1]
end
|
#unify_namespaces(ns1, ns2) ⇒ Array(String or nil, Boolean) (protected)
Unifies two namespaces, returning a namespace that works for both of them if possible.
120 121 122 123 124 125 |
# File 'lib/sass/selector/simple.rb', line 120
def unify_namespaces(ns1, ns2)
return nil, false unless ns1 == ns2 || ns1.nil? || ns1 == ['*'] || ns2.nil? || ns2 == ['*']
return ns2, true if ns1 == ['*']
return ns1, true if ns2 == ['*']
[ns1 || ns2, true]
end
|