module Webpacker::Helper # Returns current Webpacker instance. # Could be overriden to use multiple Webpacker # configurations within the same app (e.g. with engines) def current_webpacker_instance Webpacker.instance end # 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 current_webpacker_instance.config.extract_css? || !stylesheet?(name) asset_path(current_webpacker_instance.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 current_webpacker_instance.config.extract_css? || !stylesheet?(name) asset_url(current_webpacker_instance.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' %> # Edit Entry def image_pack_tag(name, **options) image_tag(resolve_path_to_image(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' %> # => # def javascript_pack_tag(*names, **options) javascript_include_tag(*sources_from_manifest_entries(names, type: :javascript), **options) end # Creates script tags that references the js chunks from entrypoints when using split chunks API, # 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 and all the dependent chunks. In production mode, the digested reference is automatically looked up. # See: https://webpack.js.org/plugins/split-chunks-plugin/ # Example: # # <%= javascript_packs_with_chunks_tag 'calendar', 'map', 'data-turbolinks-track': 'reload' %> # => # # # # # # DO: # <%= javascript_packs_with_chunks_tag 'calendar', 'map' %> # DON'T: # <%= javascript_packs_with_chunks_tag 'calendar' %> # <%= javascript_packs_with_chunks_tag 'map' %> def javascript_packs_with_chunks_tag(*names, **options) javascript_include_tag(*sources_from_manifest_entrypoints(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' %> # => # def stylesheet_pack_tag(*names, **options) if current_webpacker_instance.config.extract_css? stylesheet_link_tag(*sources_from_manifest_entries(names, type: :stylesheet), **options) end end # Creates link tags that references the css chunks from entrypoints when using split chunks API, # 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 and all the dependent chunks. In production mode, the digested reference is automatically looked up. # See: https://webpack.js.org/plugins/split-chunks-plugin/ # Example: # # <%= stylesheet_packs_with_chunks_tag 'calendar', 'map' %> # => # # # # DO: # <%= stylesheet_packs_with_chunks_tag 'calendar', 'map' %> # DON'T: # <%= stylesheet_packs_with_chunks_tag 'calendar' %> # <%= stylesheet_packs_with_chunks_tag 'map' %> def stylesheet_packs_with_chunks_tag(*names, **options) if current_webpacker_instance.config.extract_css? stylesheet_link_tag(*sources_from_manifest_entrypoints(names, type: :stylesheet), **options) end end private def stylesheet?(name) File.extname(name) == ".css" end def sources_from_manifest_entries(names, type:) names.map { |name| current_webpacker_instance.manifest.lookup!(name, type: type) }.flatten end def sources_from_manifest_entrypoints(names, type:) names.map { |name| current_webpacker_instance.manifest.lookup_pack_with_chunks!(name, type: type) }.flatten.uniq end def resolve_path_to_image(name) path = name.starts_with?("media/images/") ? name : "media/images/#{name}" asset_path(current_webpacker_instance.manifest.lookup!(path)) rescue asset_path(current_webpacker_instance.manifest.lookup!(name)) end end