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

#filename ⇒ String?

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

Returns:

  • (String, nil) 


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

def filename
  @filename
end

#line ⇒ Fixnum

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

Returns:

  • (Fixnum) 


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.

Parameters:

  • other (Object) —

    The object to test equality against

Returns:

  • (Boolean) —

    Whether or not this is equal to other



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.

Returns:

  • (Boolean) 


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

#hash ⇒ Fixnum

Returns a hash code for this sequence.

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

Returns:

  • (Fixnum) 


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

def hash
  @_hash ||= _hash
end

#specificity ⇒ Fixnum, 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.

Returns:

  • (Fixnum, Range) 


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

def specificity
  _specificity(members)
end

#to_s ⇒ String

Returns the selector string.

Returns:

  • (String) 


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

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