lib/webpacker/helper.rb
module Webpacker::Helper # Computes the relative path for a given Webpacker asset. # Return relative path using manifest.json and passes it to asset_path helper # This will use asset_path internally, so most of their behaviors will be the same. # # Example: # # # When extract_css is false in webpacker.yml and the file is a css: # <%= asset_pack_path 'calendar.css' %> # => nil # # # When extract_css is true in webpacker.yml or the file is not a css: # <%= asset_pack_path 'calendar.css' %> # => "/packs/calendar-1016838bab065ae1e122.css" def asset_pack_path(name, **options) if Webpacker.config.extract_css? || !stylesheet?(name) asset_path(Webpacker.manifest.lookup!(name), **options) end end # Computes the absolute path for a given Webpacker asset. # Return absolute path using manifest.json and passes it to asset_url helper # This will use asset_url internally, so most of their behaviors will be the same. # # Example: # # # When extract_css is false in webpacker.yml and the file is a css: # <%= asset_pack_url 'calendar.css' %> # => nil # # # When extract_css is true in webpacker.yml or the file is not a css: # <%= asset_pack_url 'calendar.css' %> # => "http://example.com/packs/calendar-1016838bab065ae1e122.css" def asset_pack_url(name, **options) if Webpacker.config.extract_css? || !stylesheet?(name) asset_url(Webpacker.manifest.lookup!(name), **options) end end # Creates a image tag that references the named pack file. # # Example: # # <%= image_pack_tag 'application.png', size: '16x10', alt: 'Edit Entry' %> # <img alt='Edit Entry' src='/packs/application-k344a6d59eef8632c9d1.png' width='16' height='10' /> def image_pack_tag(name, **options) image_tag(asset_path(Webpacker.manifest.lookup!(name)), **options) end # Creates a script tag that references the named pack file, as compiled by webpack per the entries list # in config/webpack/shared.js. By default, this list is auto-generated to match everything in # app/javascript/packs/*.js. In production mode, the digested reference is automatically looked up. # # Example: # # <%= javascript_pack_tag 'calendar', 'data-turbolinks-track': 'reload' %> # => # <script src="/packs/calendar-1016838bab065ae1e314.js" data-turbolinks-track="reload"></script> def javascript_pack_tag(*names, **options) javascript_include_tag(*sources_from_pack_manifest(names, type: :javascript), **options) end # Creates a link tag that references the named pack file, as compiled by webpack per the entries list # in config/webpack/shared.js. By default, this list is auto-generated to match everything in # app/javascript/packs/*.js. In production mode, the digested reference is automatically looked up. # # Note: If the development server is running and hot module replacement is active, this will return nothing. # In that setup you need to configure your styles to be inlined in your JavaScript for hot reloading. # # Examples: # # # When extract_css is false in webpacker.yml: # <%= stylesheet_pack_tag 'calendar', 'data-turbolinks-track': 'reload' %> # => # nil # # # When extract_css is true in webpacker.yml: # <%= stylesheet_pack_tag 'calendar', 'data-turbolinks-track': 'reload' %> # => # <link rel="stylesheet" media="screen" href="/packs/calendar-1016838bab065ae1e122.css" data-turbolinks-track="reload" /> def stylesheet_pack_tag(*names, **options) if Webpacker.config.extract_css? stylesheet_link_tag(*sources_from_pack_manifest(names, type: :stylesheet), **options) end end private def stylesheet?(name) File.extname(name) == ".css" end def sources_from_pack_manifest(names, type:) names.map { |name| Webpacker.manifest.lookup!(name, type: type) }.flatten end end