Skip to content
This repository
tree: 05e02deb68
Fetching contributors…

Octocat-spinner-32-eaf2f5

Cannot retrieve contributors at this time

file 149 lines (136 sloc) 7.84 kb
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148
require 'active_support/concern'
require 'active_support/core_ext/file'
require 'action_view/helpers/asset_tag_helpers/asset_include_tag'

module ActionView
  module Helpers
    module AssetTagHelper

      class StylesheetIncludeTag < AssetIncludeTag
        def asset_name
          'stylesheet'
        end

        def extension
          'css'
        end

        def asset_tag(source, options)
          # We force the :request protocol here to avoid a double-download bug in IE7 and IE8
          tag("link", { "rel" => "stylesheet", "type" => Mime::CSS, "media" => "screen", "href" => path_to_asset(source, :protocol => :request) }.merge(options))
        end

        def custom_dir
          config.stylesheets_dir
        end
      end


      module StylesheetTagHelpers
        extend ActiveSupport::Concern

        module ClassMethods
          # Register one or more stylesheet files to be included when <tt>symbol</tt>
          # is passed to <tt>stylesheet_link_tag</tt>. This method is typically intended
          # to be called from plugin initialization to register stylesheet files
          # that the plugin installed in <tt>public/stylesheets</tt>.
          #
          # ActionView::Helpers::AssetTagHelper.register_stylesheet_expansion :monkey => ["head", "body", "tail"]
          #
          # stylesheet_link_tag :monkey # =>
          # <link href="/stylesheets/head.css" media="screen" rel="stylesheet" type="text/css" />
          # <link href="/stylesheets/body.css" media="screen" rel="stylesheet" type="text/css" />
          # <link href="/stylesheets/tail.css" media="screen" rel="stylesheet" type="text/css" />
          def register_stylesheet_expansion(expansions)
            style_expansions = StylesheetIncludeTag.expansions
            expansions.each do |key, values|
              style_expansions[key] = (style_expansions[key] || []) | Array(values)
            end
          end
        end

        # Computes the path to a stylesheet asset in the public stylesheets directory.
        # If the +source+ filename has no extension, <tt>.css</tt> will be appended (except for explicit URIs).
        # Full paths from the document root will be passed through.
        # Used internally by +stylesheet_link_tag+ to build the stylesheet path.
        #
        # ==== Examples
        # stylesheet_path "style" # => /stylesheets/style.css
        # stylesheet_path "dir/style.css" # => /stylesheets/dir/style.css
        # stylesheet_path "/dir/style.css" # => /dir/style.css
        # stylesheet_path "http://www.example.com/css/style" # => http://www.example.com/css/style
        # stylesheet_path "http://www.example.com/css/style.css" # => http://www.example.com/css/style.css
        def stylesheet_path(source)
          asset_paths.compute_public_path(source, 'stylesheets', :ext => 'css', :protocol => :request)
        end
        alias_method :path_to_stylesheet, :stylesheet_path # aliased to avoid conflicts with a stylesheet_path named route

        # Returns a stylesheet link tag for the sources specified as arguments. If
        # you don't specify an extension, <tt>.css</tt> will be appended automatically.
        # You can modify the link attributes by passing a hash as the last argument.
        # For historical reasons, the 'media' attribute will always be present and defaults
        # to "screen", so you must explicitely set it to "all" for the stylesheet(s) to
        # apply to all media types.
        #
        # ==== Examples
        # stylesheet_link_tag "style" # =>
        # <link href="/stylesheets/style.css" media="screen" rel="stylesheet" type="text/css" />
        #
        # stylesheet_link_tag "style.css" # =>
        # <link href="/stylesheets/style.css" media="screen" rel="stylesheet" type="text/css" />
        #
        # stylesheet_link_tag "http://www.example.com/style.css" # =>
        # <link href="http://www.example.com/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 "style", :media => "print" # =>
        # <link href="/stylesheets/style.css" media="print" 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" />
        #
        # You can also include all styles in the stylesheets directory using <tt>:all</tt> as the source:
        #
        # stylesheet_link_tag :all # =>
        # <link href="/stylesheets/style1.css" media="screen" rel="stylesheet" type="text/css" />
        # <link href="/stylesheets/styleB.css" media="screen" rel="stylesheet" type="text/css" />
        # <link href="/stylesheets/styleX2.css" media="screen" rel="stylesheet" type="text/css" />
        #
        # If you want Rails to search in all the subdirectories under stylesheets, you should explicitly set <tt>:recursive</tt>:
        #
        # stylesheet_link_tag :all, :recursive => true
        #
        # == Caching multiple stylesheets into one
        #
        # You can also cache multiple stylesheets into one file, which requires less HTTP connections and can better be
        # compressed by gzip (leading to faster transfers). Caching will only happen if config.perform_caching
        # is set to true (which is the case by default for the Rails production environment, but not for the development
        # environment). Examples:
        #
        # ==== Examples
        # stylesheet_link_tag :all, :cache => true # when config.perform_caching is false =>
        # <link href="/stylesheets/style1.css" media="screen" rel="stylesheet" type="text/css" />
        # <link href="/stylesheets/styleB.css" media="screen" rel="stylesheet" type="text/css" />
        # <link href="/stylesheets/styleX2.css" media="screen" rel="stylesheet" type="text/css" />
        #
        # stylesheet_link_tag :all, :cache => true # when config.perform_caching is true =>
        # <link href="/stylesheets/all.css" media="screen" rel="stylesheet" type="text/css" />
        #
        # stylesheet_link_tag "shop", "cart", "checkout", :cache => "payment" # when config.perform_caching is false =>
        # <link href="/stylesheets/shop.css" media="screen" rel="stylesheet" type="text/css" />
        # <link href="/stylesheets/cart.css" media="screen" rel="stylesheet" type="text/css" />
        # <link href="/stylesheets/checkout.css" media="screen" rel="stylesheet" type="text/css" />
        #
        # stylesheet_link_tag "shop", "cart", "checkout", :cache => "payment" # when config.perform_caching is true =>
        # <link href="/stylesheets/payment.css" media="screen" rel="stylesheet" type="text/css" />
        #
        # The <tt>:recursive</tt> option is also available for caching:
        #
        # stylesheet_link_tag :all, :cache => true, :recursive => true
        #
        # To force concatenation (even in development mode) set <tt>:concat</tt> to true. This is useful if
        # you have too many stylesheets for IE to load.
        #
        # stylesheet_link_tag :all, :concat => true
        #
        def stylesheet_link_tag(*sources)
          @stylesheet_include ||= StylesheetIncludeTag.new(config, asset_paths)
          @stylesheet_include.include_tag(*sources)
        end

      end

    end
  end
end
Something went wrong with that request. Please try again.