Class: Sass::Selector::AbstractSequence

Inherits:
Object
  • Object
show all
Defined in:
/home/nweiz/code/sass-site/.sass/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

- (String?) filename

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

Returns:

  • (String, nil)


17
18
19
# File '/home/nweiz/code/sass-site/.sass/lib/sass/selector/abstract_sequence.rb', line 17

def filename
  @filename
end

- (Integer) line

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

Returns:

  • (Integer)


12
13
14
# File '/home/nweiz/code/sass-site/.sass/lib/sass/selector/abstract_sequence.rb', line 12

def line
  @line
end

Instance Method Details

- _specificity(arr) (protected)



94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
# File '/home/nweiz/code/sass-site/.sass/lib/sass/selector/abstract_sequence.rb', line 94

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

- (Boolean) eql?(other) 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 '/home/nweiz/code/sass-site/.sass/lib/sass/selector/abstract_sequence.rb', line 57

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

- (Integer) hash

Returns a hash code for this sequence.

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

Returns:

  • (Integer)


46
47
48
# File '/home/nweiz/code/sass-site/.sass/lib/sass/selector/abstract_sequence.rb', line 46

def hash
  @_hash ||= _hash
end

- (Boolean) invisible?

Whether or not this selector should be hidden due to containing a placeholder.

Returns:

  • (Boolean)


64
65
66
67
68
69
# File '/home/nweiz/code/sass-site/.sass/lib/sass/selector/abstract_sequence.rb', line 64

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

- (Integer, Range) specificity

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:

  • (Integer, Range)


88
89
90
# File '/home/nweiz/code/sass-site/.sass/lib/sass/selector/abstract_sequence.rb', line 88

def specificity
  _specificity(members)
end

- (String) to_s(opts = {})

Returns the selector string.

Parameters:

  • opts (Hash) (defaults to: {})

    rendering options.

  • placeholders (Hash)

    a customizable set of options

Options Hash (opts):

  • :style (Symbol)

    The css rendering style.

Returns:

  • (String)


78
79
80
# File '/home/nweiz/code/sass-site/.sass/lib/sass/selector/abstract_sequence.rb', line 78

def to_s(opts = {})
  Sass::Util.abstract(self)
end