DEV Community

Cover image for How to exclude stylesheets from the bundle and lazy load them in Angular?
Dharmen Shah
Dharmen Shah

Posted on • Originally published at indepth.dev

2 1

How to exclude stylesheets from the bundle and lazy load them in Angular?

We will try to understand this by taking example of multiple themes support.

Multiple theme files

Let’s assume that apart from main styles.css file, you have 2 theme files present:

  1. src/styles/themes/theme-light.css
  2. src/styles/themes/theme-dark.css

Next, you would have them in angular.json’s styles option:

"styles": [
    "src/styles.css",
    "src/styles/themes/theme-light.css",
    "src/styles/themes/theme-dark.css"
  ]
Enter fullscreen mode Exit fullscreen mode

And lastly, you would handle loading of a particular theme based on the users’ choice or their preferences.

Everything works great, but both of your theme files are part of your application bundle all the time.

Exclude theme files

Let’s make a minor change in angular.json to exclude theme files from bundle:

"styles": [
    "src/styles.css",
    {
      "input": "src/styles/themes/theme-light.css",
      "inject": false,
      "bundleName": "theme-light"
    },
    {
      "input": "src/styles/themes/theme-dark.css",
      "inject": false,
      "bundleName": "theme-dark"
    }
  ]
Enter fullscreen mode Exit fullscreen mode

Two new options to learn here:

  1. inject: Setting this false will not include the file from “input” path in bundle
  2. bundleName: A separate bundle will be created containing the stylesheet from “input” path

Now if you try to build the project, it will create separate files and the output will look something like below:

output of npm run build command

Notice that theme-light.css and theme-dark.css are part of Lazy Chunk Files. Lazy chunk files speed up the application load time, because they are loaded on demand.

Lazy load theme files

We managed to exclude them from the bundle and they are externally available. Now the question arises how to load these theme files?

One way to load them is to use their bundle directly with a link tag:

<link
  rel="stylesheet"
  href="theme-dark.css"
  media="(prefers-color-scheme: dark)" />
<link
  rel="stylesheet"
  href="them-light.css"
  media="(prefers-color-scheme: light)"
/>
Enter fullscreen mode Exit fullscreen mode

You will maybe need to tweak the document base URL using base tag to successfully load them.

Conclusion

We learnt that we can exclude stylesheets by simply setting inject false in workspace configuration file, i.e. angular.json. And to load them on demand, we will use the bundleName option.

The advantage of excluding stylesheets from the bundle is reduced bundle size, which will in turn improve the initial load time of application and finally user experience will be better.

Image of Timescale

🚀 pgai Vectorizer: SQLAlchemy and LiteLLM Make Vector Search Simple

We built pgai Vectorizer to simplify embedding management for AI applications—without needing a separate database or complex infrastructure. Since launch, developers have created over 3,000 vectorizers on Timescale Cloud, with many more self-hosted.

Read more →

Top comments (0)

Billboard image

The Next Generation Developer Platform

Coherence is the first Platform-as-a-Service you can control. Unlike "black-box" platforms that are opinionated about the infra you can deploy, Coherence is powered by CNC, the open-source IaC framework, which offers limitless customization.

Learn more

👋 Kindness is contagious

Please leave a ❤️ or a friendly comment on this post if you found it helpful!

Okay