filamentgroup/loadCSS — 6.6k★ on GitHub (JavaScript). Load CSS asynchronously
Snapshot summary built from the project's own GitHub metadata — there's no written TopGit review yet. The page will update automatically when a full review is published.
WHY NO REVIEW YET
TopGit writes full reviews for the most-starred, most-requested repositories. This page is a snapshot until then — see the READ ME tab for the original README in full.
:warning: This project is archived and the repository is no longer maintained.
loadCSS
A pattern for loading CSS asynchronously
[c]2020 @scottjehl, @zachleat Filament Group, Inc.
Licensed MIT
Why an ansychronous CSS loader?
Referencing CSS stylesheets with link[rel=stylesheet] or @import causes browsers to delay page rendering while a stylesheet loads. When loading stylesheets that are not critical to the initial rendering of a page, this blocking behavior is undesirable. The pattern below allows us to fetch and apply CSS asynchronously. If necessary, this repo also offers a separate (and optional) JavaScript function for loading stylesheets dynamically.
How to use
As a primary pattern, we recommend loading asynchronous CSS like this from HTML:
This article explains why this approach is best: https://www.filamentgroup.com/lab/load-css-simpler/
That is probably all you need! But if you want to load a CSS file from a JavaScript function, read on...
Dynamic CSS loading with the loadCSS function
The loadCSS.js file exposes a global loadCSS function that you can call to load CSS files programmatically, if needed. This is handy for cases where you need to dynamically load CSS from script.
loadCSS( "path/to/mystylesheet.css" );
The code above will insert a new CSS stylesheet linkafter the last stylesheet or script that it finds in the page, and the function will return a reference to that link element, should you want to reference it later in your script. Multiple calls to loadCSS will reference CSS files in the order they are called, but keep in mind that they may finish loading in a different order than they were called.
Function API
The loadCSS function has 3 optional arguments.
before: By default, loadCSS attempts to inject the stylesheet link after all CSS and JS in the page. However, if you desire a more specific location in your document, such as before a particular stylesheet link, you can use the before argument to specify a particular element to use as an insertion point. Your stylesheet will be inserted before the element you specify. For example, here's how that can be done by simply applying an id attribute to your script.
<head>
...
<script id="loadcss">
// load a CSS file just before the script element containing this code
loadCSS( "path/to/mystylesheet.css", document.getElementById("loadcss") );
</script>
...
</head>
media: You can optionally pass a string to the media argument to set the media="" of the stylesheet - the default value is all.
attributes: You can also optionally pass an Object of attribute name/attribute value pairs to set on the stylesheet. This can be used to specify Subresource Integrity attributes:
Onload event support for link elements is spotty in some browsers, so if you need to add an onload callback, include onloadCSS function on your page and use the onloadCSS function:
var stylesheet = loadCSS( "path/to/mystylesheet.css" );
onloadCSS( stylesheet, function() {
console.log( "Stylesheet has loaded." );
});
Browser Support
The loadCSS patterns attempt to load a css file asynchronously in any JavaScript-capable browser. However, some older browsers such as Internet Explorer 8 and older will block rendering while the stylesheet is loading. This merely means that the stylesheet will load as if you referenced it with an ordinary link element.
Changes in version 3.0 (no more preload polyfill)
As of version 3.0, we no longer support or include a polyfill for a rel=preload markup pattern. This is because we have since determined that the markup pattern described at the top of this readme is simpler and better for performance, while the former preload pattern could sometimes conflict with resource priorities in ways that aren't helpful for loading CSS in a non-blocking way.
To update, you can change your preload markup to this HTML pattern and delete the JS from your build.
Since this change breaks the API from prior versions, we made it a major version bump. That way, if you are still needing to use the now-deprecated preload pattern, you can keep your code pointing at prior versions that are still on NPM, such as version 2.1.0 https://github.com/filamentgroup/loadCSS/releases/tag/v2.1.0
Contributions and bug fixes
Both are very much appreciated - especially bug fixes. As for contributions, the goals of this project are to keep things very simple and utilitarian, so if we don't accept a feature addition, it's not necessarily because it's a bad idea. It just may not meet the goals of the project. Thanks!
Does filamentgroup/loadCSS have a project website?
No homepage URL was recorded for filamentgroup/loadCSS in TopGit's last sync. The README tab above frequently contains screenshots and demo links, or check the repository description on GitHub.
Does filamentgroup/loadCSS have any tags?
TopGit's last sync did not record any GitHub topics for filamentgroup/loadCSS. GitHub topics appear in the right sidebar of a repository page; that's the authoritative place to check.
How active is development on filamentgroup/loadCSS?
The most recent commit recorded on filamentgroup/loadCSS was 3.8 years ago, based on the GitHub push timestamp. The repository has 519 forks — one of the better signals of community interest.
How many stars does filamentgroup/loadCSS have?
filamentgroup/loadCSS has 6.6k GitHub stars — refresh the page for the live number, or check github.com/filamentgroup/loadCSS. TopGit mirrors GitHub's count but does not claim minute-by-minute accuracy.
What language is filamentgroup/loadCSS written in?
filamentgroup/loadCSS is written primarily in JavaScript. GitHub's language field is based on the largest share of bytes in the default branch.
What license does filamentgroup/loadCSS use?
filamentgroup/loadCSS is released under the MIT license. Always verify the LICENSE file directly on GitHub for the authoritative terms — license strings can be edited out of sync with a project's actual stance.
Where do I read more about filamentgroup/loadCSS?
This TopGit page is a snapshot — the READ ME tab shows the project's own README content (links stripped, images preserved). The GitHub repository at github.com/filamentgroup/loadCSS is the definitive source.
Read full README in the tab above.
Want a second opinion on loadCSS?
Ask an AI that can read this page — one click and you get its take on loadCSS.
/loadCSS