require 'cgi' require File.dirname(__FILE__) + '/url_helper' require File.dirname(__FILE__) + '/tag_helper' module ActionView module Helpers # Provides methods for linking a HTML page together with other assets, such as javascripts, stylesheets, and feeds. module AssetTagHelper # 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 # => # # auto_discovery_link_tag(:atom) # => # # auto_discovery_link_tag(:rss, :action => "feed") # => # def auto_discovery_link_tag(type = :rss, options = {}) tag( "link", "rel" => "alternate", "type" => "application/#{type}+xml", "title" => type.to_s.upcase, "href" => url_for(options.merge(:only_path => false)) ) end # Returns path to a javascript asset. Example: # # javascript_path "xmlhr" # => /javascripts/xmlhr.js def javascript_path(source) compute_public_path(source, 'javascripts', 'js') end # Returns a script include tag per source given as argument. Examples: # # javascript_include_tag "xmlhr" # => # # # javascript_include_tag "common.javascript", "/elsewhere/cools" # => # # def javascript_include_tag(*sources) sources.collect { |source| source = javascript_path(source) content_tag("script", "", "type" => "text/javascript", "src" => source) }.join("\n") end # Returns path to a stylesheet asset. Example: # # stylesheet_path "style" # => /stylesheets/style.css def stylesheet_path(source) compute_public_path(source, 'stylesheets', 'css') end # Returns a css link tag per source given as argument. Examples: # # stylesheet_link_tag "style" # => # # # stylesheet_link_tag "random.styles", "/css/stylish" # => # # def stylesheet_link_tag(*sources) sources.collect { |source| source = stylesheet_path(source) tag("link", "rel" => "Stylesheet", "type" => "text/css", "media" => "screen", "href" => source) }.join("\n") end # 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" def image_path(source) compute_public_path(source, 'images', 'png') end # 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" def image_tag(source, options = {}) options.symbolize_keys options[:src] = image_path(source) options[:alt] ||= source.split("/").last.split(".").first.capitalize if options[:size] options[:width], options[:height] = options[:size].split("x") options.delete :size end tag("img", options) end private def compute_public_path(source, dir, ext) source = "/#{dir}/#{source}" unless source.include?("/") source = "#{source}.#{ext}" unless source.include?(".") source = "#{@request.relative_url_root}#{source}" source end end end end