ActionView::Helpers::AssetTagHelper

stylesheet_link_tag

API docs (Rails 8.1.4.1) ↗
def stylesheet_link_tag(*sources)

Description

Creates a <link> that loads a CSS file.

Arguments

Changing a value updates the ERB and HTML.

Used as the href attribute. Depending on the value:
  • :all or :app (only as the first source): outputs a <link> for every CSS asset with :all, or only for the CSS in app/assets with :app. Any other sources are ignored. This comes from Propshaft.
  • A URL (a string starting with https:// or another …://, //, data: or cid:): used as is.
  • A string starting with / ("/legacy.css"): used as is.
  • Any other string ("application"): looks up the asset (a file in app/assets) and uses its path, with a digest added to the file name. If the asset is not found, raises Propshaft::MissingAssetError. The lookup and digest come from Propshaft; in an app without an asset pipeline, it just prepends /stylesheets/ to the path.
Unless it is a URL, the trailing .css can be left out ("/legacy" becomes /legacy.css).
= nil 
"/legacy.css"
The second and later sources. Any number can be given; each gets its own <link>, joined with newlines. This page lets you try up to the second.
options= {}
"print"
Sets the media attribute. By default, it is omitted (or set to screen if config.action_view.apply_stylesheet_media_default is true).
"preload"
Sets the rel attribute instead of the default stylesheet.
true adds crossorigin="anonymous". A string sets the crossorigin attribute.
"sha384-abc"
Accepts:
  • A string: sets the integrity attribute as is.
  • true: sets it to the asset hash that Propshaft computes. This site does not configure the hash algorithm (config.assets.integrity_hash_algorithm), so nothing is added.
Propshaft adds no integrity attribute, even for a string, to a request that is neither https nor local.
"cdn.example.com"
Prepends the given host to the path, using http or https to match the current request.
true skips the asset lookup and prepends /stylesheets/ to the path.
Common options

Rails handles these options the same way in every helper. Options the HTML spec does not allow on the <link>, and ones this site considers rarely used, are not listed here.

Shared by all helpers

{active: true, hidden: false}
A hash gives the keys whose values are not false or nil, joined with spaces. An array gives its elements joined with spaces, after removing nil, false and empty strings (including whitespace-only strings).
{controller: "tags", tags_suggestions_value: ["ruby", "rails"]}
A hash adds data-* attributes, with _ in the keys converted to -. Array and hash values are converted to JSON strings.
{describedby: ["name_help", "name_error"], invalid: false}
Like :data, adds aria-* attributes. Array values are joined with spaces, leaving out nil and empty strings (nothing is added if none remain). For a hash value, the keys whose values are not false or nil are joined with spaces.
Any other options become HTML attributes of the <link>; those with a nil value are left out.

ERB

Changes from the previous output: Added Removed Changed


          

        


        

          

            
HTML