Module: Jammit::Helper

Defined in:

lib/jammit/helper.rb

Overview

Constant Summary

DATA_URI_START =

"<!--[if (!IE)|(gte IE 8)]><!-->"

DATA_URI_END =

"<!--<![endif]-->"

MHTML_START =

"<!--[if lte IE 7]>"

MHTML_END =

"<![endif]-->"

Instance Method Summary (collapse)

• - (Object) embedded_image_stylesheets(packages, options) private

  HTML tags for the ‘datauri’, and ‘mhtml’ versions of the packaged stylesheets, using conditional comments to load the correct variant.

• - (Object) html_safe(string) private
• - (Object) include_javascripts(*packages)

  Writes out the URL to the bundled and compressed javascript package, except in development, where it references the individual scripts.

• - (Object) include_stylesheets(*packages)

  If embed_assets is turned on, writes out links to the Data-URI and MHTML versions of the stylesheet package, otherwise the package is regular compressed CSS, and in development the stylesheet URLs are passed verbatim.

• - (Object) include_templates(*packages)

  Writes out the URL to the concatenated and compiled JST file — we always have to pre-process it, even in development.

• - (Object) individual_stylesheets(packages, options) private

  HTML tags, in order, for all of the individual stylesheets.

• - (Object) packaged_stylesheets(packages, options) private

  HTML tags for the stylesheet packages.

• - (Boolean) should_package? private
• - (Object) tags_with_options(packages, options) private

  Generate the stylesheet tags for a batch of packages, with options, by yielding each package to a block.

66
67
68
69
70
71
72

# File 'lib/jammit/helper.rb', line 66

def embedded_image_stylesheets(packages, options)
  datauri_tags = tags_with_options(packages, options) {|p| Jammit.asset_url(p, :css, :datauri) }
  ie_tags = Jammit.mhtml_enabled ?
            tags_with_options(packages, options) {|p| Jammit.asset_url(p, :css, :mhtml) } :
            packaged_stylesheets(packages, options)
  [DATA_URI_START, datauri_tags, DATA_URI_END, MHTML_START, ie_tags, MHTML_END].join("\n")
end

50
51
52

# File 'lib/jammit/helper.rb', line 50

def html_safe(string)
  string.respond_to?(:html_safe) ? string.html_safe : string
end

27
28
29
30
31
32
33
34
35

# File 'lib/jammit/helper.rb', line 27

def include_javascripts(*packages)
  options = packages.extract_options!
  options.merge!(:extname=>false)
  html_safe packages.map {|pack|
    should_package? ? Jammit.asset_url(pack, :js) : Jammit.packager.individual_urls(pack.to_sym, :js)
  }.flatten.map {|pack|
    "<script src=\"#{pack}\"></script>"
  }.join("\n")
end

17
18
19
20
21
22
23

# File 'lib/jammit/helper.rb', line 17

def include_stylesheets(*packages)
  options = packages.extract_options!
  return html_safe(individual_stylesheets(packages, options)) unless should_package?
  disabled = (options.delete(:embed_assets) == false) || (options.delete(:embed_images) == false)
  return html_safe(packaged_stylesheets(packages, options)) if disabled || !Jammit.embed_assets
  return html_safe(embedded_image_stylesheets(packages, options))
end

39
40
41

# File 'lib/jammit/helper.rb', line 39

def include_templates(*packages)
  raise DeprecationError, "Jammit 0.5+ no longer supports separate packages for templates.\nYou can include your JST alongside your JS, and use include_javascripts."
end

55
56
57

# File 'lib/jammit/helper.rb', line 55

def individual_stylesheets(packages, options)
  tags_with_options(packages, options) {|p| Jammit.packager.individual_urls(p.to_sym, :css) }
end

60
61
62

# File 'lib/jammit/helper.rb', line 60

def packaged_stylesheets(packages, options)
  tags_with_options(packages, options) {|p| Jammit.asset_url(p, :css) }
end

46
47
48

# File 'lib/jammit/helper.rb', line 46

def should_package?
  Jammit.package_assets && !(Jammit.allow_debugging && params[:debug_assets])
end

76
77
78
79
80
81
82

# File 'lib/jammit/helper.rb', line 76

def tags_with_options(packages, options)
  packages.dup.map {|package|
    yield package
  }.flatten.map {|package|
    stylesheet_link_tag package, options
  }.join("\n")
end