Class: Sass::Selector::AbstractSequence

Inherits:
Object
  • Object
show all
Defined in:
lib/sass/selector/abstract_sequence.rb

Overview

The abstract parent class of the various selector sequence classes.

All subclasses should implement a members method that returns an array of object that respond to #line= and #filename=, as well as a to_s method that returns the string representation of the selector.

Direct Known Subclasses

CommaSequence, Sequence, SimpleSequence

Instance Attribute Summary collapse

Instance Method Summary collapse

Instance Attribute Details

#filenameString?

The name of the file in which this selector was declared.


17
18
19
# File 'lib/sass/selector/abstract_sequence.rb', line 17

def filename
  @filename
end

#lineFixnum

The line of the Sass template on which this selector was declared.


12
13
14
# File 'lib/sass/selector/abstract_sequence.rb', line 12

def line
  @line
end

Instance Method Details

#_specificity(arr) (protected)


91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
# File 'lib/sass/selector/abstract_sequence.rb', line 91

def _specificity(arr)
  min = 0
  max = 0
  arr.each do |m|
    next if m.is_a?(String)
    spec = m.specificity
    if spec.is_a?(Range)
      min += spec.begin
      max += spec.end
    else
      min += spec
      max += spec
    end
  end
  min == max ? min : (min..max)
end

#eql?(other) ⇒ Boolean Also known as: ==

Checks equality between this and another object.

Subclasses should define #_eql? rather than overriding this method, which handles checking class equality and hash equality.


57
58
59
# File 'lib/sass/selector/abstract_sequence.rb', line 57

def eql?(other)
  other.class == self.class && other.hash == hash && _eql?(other)
end

#has_placeholder?Boolean

Whether or not this selector sequence contains a placeholder selector. Checks recursively.


64
65
66
67
68
69
70
# File 'lib/sass/selector/abstract_sequence.rb', line 64

def has_placeholder?
  @has_placeholder ||= members.any? do |m|
    next m.has_placeholder? if m.is_a?(AbstractSequence)
    next m.selector && m.selector.has_placeholder? if m.is_a?(Pseudo)
    m.is_a?(Placeholder)
  end
end

#hashFixnum

Returns a hash code for this sequence.

Subclasses should define #_hash rather than overriding this method, which automatically handles memoizing the result.


46
47
48
# File 'lib/sass/selector/abstract_sequence.rb', line 46

def hash
  @_hash ||= _hash
end

#specificityFixnum, Range

Returns the specificity of the selector.

The base is given by SPECIFICITY_BASE. This can be a number or a range representing possible specificities.


85
86
87
# File 'lib/sass/selector/abstract_sequence.rb', line 85

def specificity
  _specificity(members)
end

#to_sString

Returns the selector string.


75
76
77
# File 'lib/sass/selector/abstract_sequence.rb', line 75

def to_s
  Sass::Util.abstract(self)
end