Module: Compass::SassExtensions::Functions::Selectors

Included in:
Sass::Script::Functions
Defined in:
lib/compass/sass_extensions/functions/selectors.rb

Constant Summary collapse

COMMA_SEPARATOR = 
/\s*,\s*/

Instance Method Summary collapse

Instance Method Details

#append_selector(selector, to_append) ⇒ Object

Permute two selectors, the first may be comma delimited. The end result is a new selector that is the equivalent of nesting the second selector under the first one in a sass file and preceding it with an &. To illustrate, the following mixins are equivalent:

mixin-a(!selector, !to_append)

#{!selector}
  &#{!to_append}
    width: 2px

mixin-b(!selector, !to_append)

#{append_selector(!selector, !to_append)}
  width: 2px



35
36
37
38
39
40
 
# File 'lib/compass/sass_extensions/functions/selectors.rb', line 35

def append_selector(selector, to_append)
  ancestors = selector.value.split(COMMA_SEPARATOR)
  descendants = to_append.value.split(COMMA_SEPARATOR)
  nested = ancestors.map{|a| descendants.map{|d| "#{a}#{d}"}.join(", ")}.join(", ")
  Sass::Script::String.new(nested)
end

#headers(from = nil, to = nil) ⇒ Object Also known as: headings

Return the header selectors for the levels indicated Defaults to all headers h1 through h6 For example: headers(all) => h1, h2, h3, h4, h5, h6 headers(4) => h1, h2, h3, h4 headers(2,4) => h2, h3, h4



48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
 
# File 'lib/compass/sass_extensions/functions/selectors.rb', line 48

def headers(from = nil, to = nil)
  if from && !to
    if from.is_a?(Sass::Script::String) && from.value == "all"
      from = Sass::Script::Number.new(1)
      to = Sass::Script::Number.new(6)
    else
      to = from
      from = Sass::Script::Number.new(1)
    end
  else
    from ||= Sass::Script::Number.new(1)
    to ||= Sass::Script::Number.new(6)
  end
  Sass::Script::String.new((from.value..to.value).map{|n| "h#{n}"}.join(", "))
end

#nest(*arguments) ⇒ Object

Permute multiple selectors each of which may be comma delimited, the end result is a new selector that is the equivalent of nesting each under the previous selector. To illustrate, the following mixins are equivalent:

mixin-a(!selector1, !selector2, !selector3)

#{!selector1}
  #{selector2}
    #{selector3}
      width: 2px

mixin-b(!selector1, !selector2)

#{nest(!selector, !selector2, !selector3)}
  width: 2px



15
16
17
18
19
20
21
22
 
# File 'lib/compass/sass_extensions/functions/selectors.rb', line 15

def nest(*arguments)
  nested = arguments.map{|a| a.value}.inject do |memo,arg|
    ancestors = memo.split(COMMA_SEPARATOR)
    descendants = arg.split(COMMA_SEPARATOR)
    ancestors.map{|a| descendants.map{|d| "#{a} #{d}"}.join(", ")}.join(", ")
  end
  Sass::Script::String.new(nested)
end