ActionView::Helpers::AssetTagHelper

stylesheet_link_tag

API ドキュメント（Rails 8.1.4.1） ↗
def stylesheet_link_tag(*sources)

説明

CSS のファイルを読み込む <link> を作ります。

引数

値を変えると、ERB と HTML が変わります。

href 属性の値にします。渡す値によって、次のように変わります。
  • :all か :app（1 つ目に渡したときだけ）：:all ならアセットの CSS を全部、:app なら app/assets の中の CSS だけを、1 つずつの <link> にして並べます。ほかに渡した source は使いません。Propshaft の動きです。
  • URL（https:// のような 〜://、//、data:、cid: で始まる文字列）：そのまま href 属性の値にします。
  • / で始まる文字列（"/legacy.css"）：そのまま href 属性の値にします。
  • それ以外の文字列（"application"）：アセット（app/assets の中のファイル）を探し、ファイル名にハッシュを付けたパスにします。見つからなければ、Propshaft::MissingAssetError になります。探してハッシュを付けるのは Propshaft の動きで、アセットの仕組みを入れていないアプリでは、探さずに /stylesheets/ を前に付けたパスにします。
URL でなければ、最後の .css は省けます（"/legacy" は /legacy.css になります）。
= nil 
"/legacy.css"
2 つ目以降の source です。いくつでも渡せて、source ごとに <link> を作り、改行でつなぎます。このページで試せるのは 2 つ目までです。
options= {}
"print"
渡した値を media 属性の値にします。デフォルトでは追加しません（config.action_view.apply_stylesheet_media_default が true なら screen）。
"preload"
stylesheet の代わりに、渡した値を rel 属性の値にします。
true にすると、crossorigin="anonymous" を追加します。文字列を渡すと、その値を crossorigin 属性の値にします。
"sha384-abc"
渡す値によって、次のように変わります。
  • 文字列：そのまま integrity 属性の値にします。
  • true：Propshaft が作るアセットのハッシュを integrity 属性の値にします。このサイトはハッシュの作り方（config.assets.integrity_hash_algorithm）を設定していないので、何も追加しません。
Propshaft は、https でもローカルでもないリクエストでは、文字列を渡しても integrity 属性を追加しません。
"cdn.example.com"
渡した値を、パスの前にホストとして追加します。http か https かは、今のリクエストに合わせます。
true にすると、アセットを探さず、/stylesheets/ を前に付けたパスにします。
ヘルパー共通の options

Rails はどのヘルパーでも、これらの options を同じように処理します。HTML の仕様で <link> に使えないものや、使う場面が少ないとこのサイトで判断したものは、ここでは省いています。

すべてのヘルパー共通

{active: true, hidden: false}
Hash を渡すと、値が false と nil 以外のキーを空白でつなぎます。配列を渡すと、nil、false、空の文字列（空白だけの文字列も）を外して、空白でつなぎます。
{controller: "tags", tags_suggestions_value: ["ruby", "rails"]}
Hash を渡すと、キーの _ を - にして、data-* 属性を追加します。値に配列や Hash を渡すと、JSON の文字列にします。
{describedby: ["name_help", "name_error"], invalid: false}
:data と同じく、aria-* 属性を追加します。値が配列なら、nil と空の文字列を外して、空白でつなぎます（何も残らなければ、追加しません）。値が Hash なら、値が false と nil 以外のキーを空白でつなぎます。
ここにない options は、<link> の HTML 属性になります。値が nil なら、その HTML 属性は追加しません。

ERB

直前との違い： 追加 削除 変更


          

        


        

          

            
HTML