Module: Sass::Script::Functions

Defined in:
lib/susy/sass_extensions.rb

Instance Method Summary collapse

Instance Method Details

#base_font_size(base_font_size_px) ⇒ Object

set the Susy base font size (in pixels) return the percentage base font size

this could be done in Sass, but we need to store the px_size so we
can provide a px_to_em function



8
9
10
11
 
# File 'lib/susy/sass_extensions.rb', line 8

def base_font_size(base_font_size_px)
  @@susy_base_font_size_px = Float(base_font_size_px.value)
  Sass::Script::Number.new((@@susy_base_font_size_px / 16) * 100)
end

#column(context_columns = nil) ⇒ Object

return the percentage width of a single column in a context of

'context_columns'



74
75
76
77
78
 
# File 'lib/susy/sass_extensions.rb', line 74

def column(context_columns = nil)
  context_width = context(context_columns).value
  c = @@susy_column_width
  Sass::Script::Number.new((c / context_width) * 100)
end

#columns(number, context_columns = nil) ⇒ Object

return the percentage width of ‘number’ columns in a context of

'context_columns'



49
50
51
52
53
54
 
# File 'lib/susy/sass_extensions.rb', line 49

def columns(number, context_columns = nil)
  n = number.value
  context_width = context(context_columns).value
  c, g = [@@susy_column_width, @@susy_gutter_width]
  Sass::Script::Number.new((((n * c) + ((n - 1) * g)) / context_width) * 100)
end

#container(total_columns, column_width, gutter_width, side_gutter_width) ⇒ Object

set the Susy column and gutter widths and number of columns

column, gutter and padding widths should be sent as unitless numbers, 
though they may "really" be ems or pixels (_grid.sass handles units).

return total width of container (without units)



22
23
24
25
26
27
28
 
# File 'lib/susy/sass_extensions.rb', line 22

def container(total_columns, column_width, gutter_width, side_gutter_width)
  @@susy_total_columns = total_columns.value
  @@susy_column_width = Float(column_width.value)
  @@susy_gutter_width = Float(gutter_width.value)
  @@susy_side_gutter_width = Float(side_gutter_width.value)
  context
end

#context(n = nil) ⇒ Object

return the width of ‘n’ columns plus ‘n - 1’ gutters plus page padding in non-nested contexts



32
33
34
35
36
37
38
39
40
41
42
43
44
45
 
# File 'lib/susy/sass_extensions.rb', line 32

def context(n = nil)
  begin
    n = n.value
  rescue NoMethodError
    n = false
  end
  sg = 0
  if !n
    n = @@susy_total_columns
    sg = @@susy_side_gutter_width
  end
  c, g = [@@susy_column_width, @@susy_gutter_width]
  Sass::Script::Number.new(((n * c) + ((n - 1) * g)) + (sg * 2))
end

#gutter(context_columns = nil) ⇒ Object

return the percentage width of a single gutter in a context of

'context_columns'



58
59
60
61
62
 
# File 'lib/susy/sass_extensions.rb', line 58

def gutter(context_columns = nil)
  context_width = context(context_columns).value
  g = @@susy_gutter_width
  Sass::Script::Number.new((g / context_width) * 100)
end

#px2em(size_in_px) ⇒ Object

approximate a given pixel size in ems



14
15
16
 
# File 'lib/susy/sass_extensions.rb', line 14

def px2em(size_in_px)
  Sass::Script::Number.new((size_in_px.value / @@susy_base_font_size_px))
end

#side_gutter(context_columns = nil) ⇒ Object

return the percentage width of a single side gutter in a context of

'context_columns'



66
67
68
69
70
 
# File 'lib/susy/sass_extensions.rb', line 66

def side_gutter(context_columns = nil)
  context_width = context(context_columns).value
  sg = @@susy_side_gutter_width
  Sass::Script::Number.new((sg / context_width) * 100)
end