vite-plugin-shadow-style

What it does

This plugin allows you to inject css styles into the shadow root of your web components.

How to install

Just run a simple

1npm i -D vite-plugin-shadow-style

How to use it

Declare your entry point like this:

1export function defineEntry() {
2  class MyComponentEntry extends HTMLElement {
3    public static Name = "my-component";
4    private mountPoint!: HTMLDivElement;
5
6    constructor() {
7      super();
8    }
9
10    connectedCallback() {
11      this.mountPoint = document.createElement("div");
12
13      // This is the important part, where you're creating a style tag to
14      // inject into the shadow root.
15      const style = document.createElement("style");
16      style.innerHTML = SHADOW_STYLE;
17
18      const shadowRoot = this.attachShadow({ mode: "open" });
19
20      shadowRoot.appendChild(this.mountPoint);
21      shadowRoot.appendChild(style);
22
23      ReactDOM.createRoot(this.mountPoint).render(<MandGBreakdown />);
24    }
25  }
26
27  window.customElements.get(MyComponentEntry.Name) ||
28    window.customElements.define(MyComponentEntry.Name, MyComponentEntry);
29}
30
31defineEntry();

At this point, you'll probably get errors regarding SHADOW_STYLE not being defined. To obviate this, you can create a globals.d.ts file in your project's root folder and add the following to it:

1declare const SHADOW_STYLE: string;

Now, all you'll need to do is load the plugin in your vite configuration, as the last item in the plugins array:

1import { shadowStyle } from 'vite-plugin-shadow-style';
2
3export default defineConfig({
4  build: {
5    rollupOptions: {
6      plugins: [
7        react(),
8        typescript({
9          noEmit: true,
10          allowImportingTsExtensions: true,
11        }),
12        // Here it goes!
13        shadowStyle(),
14      ],
15    },
16    minify: true,
17    sourcemap: true,
18    outDir: "dist",
19  },
20});

Handling conflicts

In some situations, a few conflicts may occur, given the fact that CSS classes may get injected by Vite inside of your bundles, translated in const declarations at the top level of your webcomponents' Javascript bundle. When importing more than one WebComponent at a time, those top-level declarations may have clashes due to their usage of the same names across different classes in different components. To solve this issue, you can use the iife flag of this plugin, in order to wrap the output bundle code in an IIFE, avoiding global-level declarations and related issues.

Example:

1// ...
2rollupOptions: {
3  shadowStyle({ iife: true }),
4},
5// ...
6