Class: Sass::Selector::Sequence

Inherits:
AbstractSequence show all
Defined in:
lib/sass/selector/sequence.rb

Overview

An operator-separated sequence of simple selector sequences.

Instance Attribute Summary collapse

Attributes inherited from AbstractSequence

#filename, #line

Instance Method Summary collapse

Methods inherited from AbstractSequence

#eql?, #hash

Constructor Details

#initialize(seqs_and_ops) ⇒ Sequence

Returns a new instance of Sequence.

Parameters:



38
39
40
# File 'lib/sass/selector/sequence.rb', line 38

def initialize(seqs_and_ops)
  @members = seqs_and_ops
end

Instance Attribute Details

#membersArray<SimpleSequence, String> (readonly)

The array of simple selector sequences, operators, and newlines. The operators are strings such as "+" and ">" representing the corresponding CSS operators. Newlines are also newline strings; these aren't semantically relevant, but they do affect formatting.

Returns:



35
36
37
# File 'lib/sass/selector/sequence.rb', line 35

def members
  @members
end

Instance Method Details

#do_extend(extends) ⇒ Array<Sequence>

Non-destructively extends this selector with the extensions specified in a hash (which should come from Tree::Visitors::Cssize).

Parameters:

Returns:

See Also:



78
79
80
81
82
83
84
85
86
87
# File 'lib/sass/selector/sequence.rb', line 78

def do_extend(extends, seen = Set.new)
  paths = Sass::Util.paths(members.map do |sseq_or_op|
      next [[sseq_or_op]] unless sseq_or_op.is_a?(SimpleSequence)
      extended = sseq_or_op.do_extend(extends, seen)
      choices = extended.map {|seq| seq.members}
      choices.unshift([sseq_or_op]) unless extended.any? {|seq| seq.superselector?(sseq_or_op)}
      choices
    end)
  Sass::Util.flatten(paths.map {|path| weave(path)}, 1).map {|p| Sequence.new(p)}
end

#filename=(filename) ⇒ String?

Sets 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). This also sets the filename for all child selectors.

Parameters:

  • filename (String, nil)

Returns:

  • (String, nil)


22
23
24
25
# File 'lib/sass/selector/sequence.rb', line 22

def filename=(filename)
  members.each {|m| m.filename = filename if m.is_a?(SimpleSequence)}
  filename
end

#inspectString

Returns a string representation of the sequence. This is basically the selector string.

Returns:

  • (String)


113
114
115
# File 'lib/sass/selector/sequence.rb', line 113

def inspect
  members.map {|m| m.inspect}.join(" ")
end

#line=(line) ⇒ Fixnum

Sets the line of the Sass template on which this selector was declared. This also sets the line for all child selectors.

Parameters:

  • line (Fixnum)

Returns:

  • (Fixnum)


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

def line=(line)
  members.each {|m| m.line = line if m.is_a?(SimpleSequence)}
  line
end

#resolve_parent_refs(super_seq) ⇒ Sequence

Resolves the Parent selectors within this selector by replacing them with the given parent selector, handling commas appropriately.

Parameters:

  • super_seq (Sequence)

    The parent selector sequence

Returns:

  • (Sequence)

    This selector, with parent references resolved

Raises:



49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
# File 'lib/sass/selector/sequence.rb', line 49

def resolve_parent_refs(super_seq)
  members = @members
  nl = (members.first == "\n" && members.shift)
  unless members.any? do |seq_or_op|
      seq_or_op.is_a?(SimpleSequence) && seq_or_op.members.first.is_a?(Parent)
    end
    members = []
    members << nl if nl
    members << SimpleSequence.new([Parent.new])
    members += @members
  end

  Sequence.new(
    members.map do |seq_or_op|
      next seq_or_op unless seq_or_op.is_a?(SimpleSequence)
      seq_or_op.resolve_parent_refs(super_seq)
    end.flatten)
end

#superselector?(sseq) ⇒ Boolean

Returns whether or not this selector matches all elements that the given selector matches (as well as possibly more).

Examples:

(.foo).superselector?(.foo.bar) #=> true
(.foo).superselector?(.bar) #=> false
(.bar .foo).superselector?(.foo) #=> false

Parameters:

Returns:

  • (Boolean)


98
99
100
101
# File 'lib/sass/selector/sequence.rb', line 98

def superselector?(sseq)
  return false unless members.size == 1
  members.last.superselector?(sseq)
end

#to_a



104
105
106
107
# File 'lib/sass/selector/sequence.rb', line 104

def to_a
  ary = @members.map {|seq_or_op| seq_or_op.is_a?(SimpleSequence) ? seq_or_op.to_a : seq_or_op}
  Sass::Util.intersperse(ary, " ").flatten.compact
end