Skip to content

subbu963/import-map-utils

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

11 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

⚡ Utilities to super-charge your ES Modules!

Utils

  1. CSS loader
  2. More upcoming

CSS loader

You can use the CSS loader to load css in your ES Modules.

The problem with loading css from ES Modules

Although there are ways to load CSS in ESM using a combination of import assertions and Constructible stylesheets(more about it here), they have one major shortcoming, i.e., @import rules. Import assertions internally uses Constructible stylesheets which doesnt allow @import rules in css files. CSS Loader tries to solve this problem by allowing you to import your css directly from your ESM while also allowing you to use @import rules.

Usage

In your html file add the following script(where assetsRoot is the path from which you css is served from) and import map:

<html>
    <head>
        ...
        <script>
            window.__importMapUtils = {
                css: {
                    assetsRoot: '/assets/'
                }
            };
        </script>
        <script type="importmap">
            {
                "imports": {
                    "import-map-utils/": "https://cdn.jsdelivr.net/npm/@subbu963/import-map-utils@0.1.4/lib/"
                }
            }
        </script>
        ...
    </head>
    ...
</html>

Then in your ES Module import your css files like this:

import styles from 'import-map-utils/css/loader.js?src=./main.css';
// Now styles are auto injected into the DOM
// Some code
// You can also unmount your styles if you want to do a cleanup like this
styles.unmount();

// You can remount it using
styles.mount();

Options

You can pass options like this:

<script>
    window.__importMapUtils = {
        css: {
            useLocation: true, // to use window.location to construct the base
            base: 'https://some-site.com/', // or pass the base manually
            assetsRoot: '/assets/' // root assets folder from which your css is served from
        }
    };
</script>

About

⚡ Utilities to super-charge your ES Modules!

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published