Provides methods for linking a HTML page together with other assets, such as javascripts, stylesheets, and feeds.

Methods
Public Instance methods
auto_discovery_link_tag(type = :rss, options = {})

Returns a link tag that browsers and news readers can use to auto-detect a RSS or ATOM feed for this page. The type can either be :rss (default) or :atom and the options follow the url_for style of declaring a link target.

Examples: 

  auto_discovery_link_tag # =>
    <link rel="alternate" type="application/rss+xml" title="RSS" href="http://www.curenthost.com/controller/action" />
  auto_discovery_link_tag(:atom) # =>
    <link rel="alternate" type="application/atom+xml" title="ATOM" href="http://www.curenthost.com/controller/action" />
  auto_discovery_link_tag(:rss, :action => "feed") # =>
    <link rel="alternate" type="application/atom+xml" title="ATOM" href="http://www.curenthost.com/controller/feed" />

[ show source ]

    # File vendor/rails/actionpack/lib/action_view/helpers/asset_tag_helper.rb, line 19
19:       def auto_discovery_link_tag(type = :rss, options = {})
20:         tag(
21:           "link", "rel" => "alternate", "type" => "application/#{type}+xml", "title" => type.to_s.upcase,
22:           "href" => url_for(options.merge(:only_path => false))
23:         )
24:       end
image_path(source)

Returns path to an image asset. Example:

The src can be supplied as a…

  • full path, like "/my_images/image.gif"
  • file name, like "rss.gif", that gets expanded to "/images/rss.gif"
  • file name without extension, like "logo", that gets expanded to "/images/logo.png"

[ show source ]

    # File vendor/rails/actionpack/lib/action_view/helpers/asset_tag_helper.rb, line 76
76:       def image_path(source)
77:         compute_public_path(source, 'images', 'png')
78:       end
image_tag(source, options = {})

Returns an image tag converting the options instead html options on the tag, but with these special cases:

  • :alt - If no alt text is given, the file name part of the src is used (capitalized and without the extension)
  • :size - Supplied as "XxY", so "30x45" becomes width="30" and height="45"

The src can be supplied as a…

  • full path, like "/my_images/image.gif"
  • file name, like "rss.gif", that gets expanded to "/images/rss.gif"
  • file name without extension, like "logo", that gets expanded to "/images/logo.png"

[ show source ]

     # File vendor/rails/actionpack/lib/action_view/helpers/asset_tag_helper.rb, line 89
 89:       def image_tag(source, options = {})
 90:         options.symbolize_keys
 91:                 
 92:         options[:src] = image_path(source)
 93:         options[:alt] ||= source.split("/").last.split(".").first.capitalize
 94:         
 95:         if options[:size]
 96:           options[:width], options[:height] = options[:size].split("x")
 97:           options.delete :size
 98:         end
 99: 
100:         tag("img", options)
101:       end
javascript_include_tag(*sources)

Returns a script include tag per source given as argument. Examples: 

  javascript_include_tag "xmlhr" # =>
    <script type="text/javascript" src="/javascripts/xmlhr.js"></script>

  javascript_include_tag "common.javascript", "/elsewhere/cools" # =>
    <script type="text/javascript" src="/javascripts/common.javascript"></script>
    <script type="text/javascript" src="/elsewhere/cools.js"></script>

[ show source ]

    # File vendor/rails/actionpack/lib/action_view/helpers/asset_tag_helper.rb, line 41
41:       def javascript_include_tag(*sources)
42:         sources.collect { |source|
43:           source = javascript_path(source)        
44:           content_tag("script", "", "type" => "text/javascript", "src" => source)
45:         }.join("\n")
46:       end
javascript_path(source)

Returns path to a javascript asset. Example: 

  javascript_path "xmlhr" # => /javascripts/xmlhr.js

[ show source ]

    # File vendor/rails/actionpack/lib/action_view/helpers/asset_tag_helper.rb, line 29
29:       def javascript_path(source)
30:         compute_public_path(source, 'javascripts', 'js')        
31:       end
stylesheet_link_tag(*sources)

Returns a css link tag per source given as argument. Examples: 

  stylesheet_link_tag "style" # =>
    <link href="/stylesheets/style.css" media="screen" rel="Stylesheet" type="text/css" />

  stylesheet_link_tag "random.styles", "/css/stylish" # =>
    <link href="/stylesheets/random.styles" media="screen" rel="Stylesheet" type="text/css" />
    <link href="/css/stylish.css" media="screen" rel="Stylesheet" type="text/css" />

[ show source ]

    # File vendor/rails/actionpack/lib/action_view/helpers/asset_tag_helper.rb, line 63
63:       def stylesheet_link_tag(*sources)
64:         sources.collect { |source|
65:           source = stylesheet_path(source)
66:           tag("link", "rel" => "Stylesheet", "type" => "text/css", "media" => "screen", "href" => source)
67:         }.join("\n")
68:       end
stylesheet_path(source)

Returns path to a stylesheet asset. Example: 

  stylesheet_path "style" # => /stylesheets/style.css

[ show source ]

    # File vendor/rails/actionpack/lib/action_view/helpers/asset_tag_helper.rb, line 51
51:       def stylesheet_path(source)
52:         compute_public_path(source, 'stylesheets', 'css')
53:       end