method

stylesheet_link_tag

v7.1.3.4 - Show latest stable - 1 note - Class: ActionView::Helpers::AssetTagHelper

stylesheet_link_tag(*sources) public

Returns a stylesheet link tag for the sources specified as arguments.

When passing paths, the .css extension is optional. If you don’t specify an extension, .css will be appended automatically. If you do not want .css appended to the path, set extname: false in the options. You can modify the link attributes by passing a hash as the last argument.

If the server supports HTTP Early Hints, Rails will push a 103 Early Hints response that links to the assets.

Options

:extname - Append an extension to the generated URL unless the extension already exists. This only applies for relative URLs.
:protocol - Sets the protocol of the generated URL. This option only applies when a relative URL and host options are provided.
:host - When a relative URL is provided the host is added to the that path.
:skip_pipeline - This option is used to bypass the asset pipeline when it is set to true.

Examples

stylesheet_link_tag "style"
# => <link href="/assets/style.css" rel="stylesheet" />

stylesheet_link_tag "style.css"
# => <link href="/assets/style.css" rel="stylesheet" />

stylesheet_link_tag "http://www.example.com/style.css"
# => <link href="http://www.example.com/style.css" rel="stylesheet" />

stylesheet_link_tag "style.less", extname: false, skip_pipeline: true, rel: "stylesheet/less"
# => <link href="/stylesheets/style.less" rel="stylesheet/less">

stylesheet_link_tag "style", media: "all"
# => <link href="/assets/style.css" media="all" rel="stylesheet" />

stylesheet_link_tag "style", media: "print"
# => <link href="/assets/style.css" media="print" rel="stylesheet" />

stylesheet_link_tag "random.styles", "/css/stylish"
# => <link href="/assets/random.styles" rel="stylesheet" />
#    <link href="/css/stylish.css" rel="stylesheet" />

Show source

# File actionview/lib/action_view/helpers/asset_tag_helper.rb, line 193
      def stylesheet_link_tag(*sources)
        options = sources.extract_options!.stringify_keys
        path_options = options.extract!("protocol", "extname", "host", "skip_pipeline").symbolize_keys
        use_preload_links_header = options["preload_links_header"].nil? ? preload_links_header : options.delete("preload_links_header")
        preload_links = []
        crossorigin = options.delete("crossorigin")
        crossorigin = "anonymous" if crossorigin == true
        nopush = options["nopush"].nil? ? true : options.delete("nopush")
        integrity = options["integrity"]

        sources_tags = sources.uniq.map { |source|
          href = path_to_stylesheet(source, path_options)
          if use_preload_links_header && href.present? && !href.start_with?("data:")
            preload_link = "<#{href}>; rel=preload; as=style"
            preload_link += "; crossorigin=#{crossorigin}" unless crossorigin.nil?
            preload_link += "; integrity=#{integrity}" unless integrity.nil?
            preload_link += "; nopush" if nopush
            preload_links << preload_link
          end
          tag_options = {
            "rel" => "stylesheet",
            "crossorigin" => crossorigin,
            "href" => href
          }.merge!(options)

          if apply_stylesheet_media_default && tag_options["media"].blank?
            tag_options["media"] = "screen"
          end

          tag(:link, tag_options)
        }.join("\n").html_safe

        if use_preload_links_header
          send_preload_links_header(preload_links)
        end

        sources_tags
      end

April 6, 2009

3 thanks

Assets hosts

You can also setup assets hosts in enviroments:

config.action_controller.asset_host = "http://your-assets-server.com"

stylesheet_link_tag

Related methods

Options

Examples

Assets hosts