Module: ActionView::Helpers::AssetTagHelper
- Defined in:
- lib/action_view/helpers/asset_tag_helper.rb
Overview
Provides methods for linking a HTML page together with other assets, such as javascripts, stylesheets, and feeds.
Instance Method Summary collapse
-
#auto_discovery_link_tag(type = :rss, options = {}, tag_options = {}) ⇒ Object
Returns a link tag that browsers and news readers can use to auto-detect a RSS or ATOM feed for this page.
-
#image_path(source) ⇒ Object
Returns path to an image asset.
-
#image_tag(source, options = {}) ⇒ Object
Returns an image tag converting the
options
instead html options on the tag, but with these special cases:. -
#javascript_include_tag(*sources) ⇒ Object
Returns a script include tag per source given as argument.
-
#javascript_path(source) ⇒ Object
Returns path to a javascript asset.
-
#stylesheet_link_tag(*sources) ⇒ Object
Returns a css link tag per source given as argument.
-
#stylesheet_path(source) ⇒ Object
Returns path to a stylesheet asset.
Instance Method Details
#auto_discovery_link_tag(type = :rss, options = {}, tag_options = {}) ⇒ Object
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/rss+xml" title="RSS" href="http://www.curenthost.com/controller/feed" />
auto_discovery_link_tag(:rss, {:action => "feed"}, {:title => "My RSS"}) # =>
<link rel="alternate" type="application/rss+xml" title="My RSS" href="http://www.curenthost.com/controller/feed" />
21 22 23 24 25 26 27 28 29 |
# File 'lib/action_view/helpers/asset_tag_helper.rb', line 21 def auto_discovery_link_tag(type = :rss, = {}, = {}) tag( "link", "rel" => [:rel] || "alternate", "type" => [:type] || "application/#{type}+xml", "title" => [:title] || type.to_s.upcase, "href" => url_for(.merge(:only_path => false)) ) end |
#image_path(source) ⇒ Object
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”
93 94 95 |
# File 'lib/action_view/helpers/asset_tag_helper.rb', line 93 def image_path(source) compute_public_path(source, 'images', 'png') end |
#image_tag(source, options = {}) ⇒ Object
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 thesrc
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”
106 107 108 109 110 111 112 113 114 115 116 117 118 |
# File 'lib/action_view/helpers/asset_tag_helper.rb', line 106 def image_tag(source, = {}) .symbolize_keys [:src] = image_path(source) [:alt] ||= File.basename([:src], '.*').split('.').first.capitalize if [:size] [:width], [:height] = [:size].split("x") .delete :size end tag("img", ) end |
#javascript_include_tag(*sources) ⇒ Object
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>
javascript_include_tag :defaults # =>
<script type="text/javascript" src="/javascripts/prototype.js"></script>
<script type="text/javascript" src="/javascripts/effects.js"></script>
<script type="text/javascript" src="/javascripts/controls.js"></script>
<script type="text/javascript" src="/javascripts/dragdrop.js"></script>
52 53 54 55 56 57 58 59 |
# File 'lib/action_view/helpers/asset_tag_helper.rb', line 52 def javascript_include_tag(*sources) = sources.last.is_a?(Hash) ? sources.pop.stringify_keys : { } sources = ['prototype', 'effects', 'controls', 'dragdrop'] if sources.first == :defaults sources.collect { |source| source = javascript_path(source) content_tag("script", "", { "type" => "text/javascript", "src" => source }.merge()) }.join("\n") end |
#javascript_path(source) ⇒ Object
Returns path to a javascript asset. Example:
javascript_path "xmlhr" # => /javascripts/xmlhr.js
34 35 36 |
# File 'lib/action_view/helpers/asset_tag_helper.rb', line 34 def javascript_path(source) compute_public_path(source, 'javascripts', 'js') end |
#stylesheet_link_tag(*sources) ⇒ Object
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 "style", :media => "all" # =>
<link href="/stylesheets/style.css" media="all" 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" />
79 80 81 82 83 84 85 |
# File 'lib/action_view/helpers/asset_tag_helper.rb', line 79 def stylesheet_link_tag(*sources) = sources.last.is_a?(Hash) ? sources.pop.stringify_keys : { } sources.collect { |source| source = stylesheet_path(source) tag("link", { "rel" => "Stylesheet", "type" => "text/css", "media" => "screen", "href" => source }.merge()) }.join("\n") end |
#stylesheet_path(source) ⇒ Object
Returns path to a stylesheet asset. Example:
stylesheet_path "style" # => /stylesheets/style.css
64 65 66 |
# File 'lib/action_view/helpers/asset_tag_helper.rb', line 64 def stylesheet_path(source) compute_public_path(source, 'stylesheets', 'css') end |