The page must load the CSS and JavaScript. It can be placed anywhere but, typically, the CSS is loaded in the <head> and the JS is loaded just before the closing </body> tag:

<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/theme.js/dist/theme.css">
<script src="https://cdn.jsdelivr.net/npm/theme.js/dist/theme.js"></script>

CDN URLs are shown above but you can also npm i theme.js to install via npm and use a bundler.

Now create a theme toggle switch on your page by adding a data-toggled="themejs" attribute to any element, e.g.

<p data-toggled="themejs">theme</p>

This can be styled however you prefer but it should be hidden by default and only shown then theme.js is active and a themejs-active class has applied to the body tag, e.g.

[data-toggled="themejs"] {
  cursor: pointer;
  display: none;
}

.themejs-active [data-toggled="themejs"] {
  display: block;
}

The element can now be clicked to toggle themes.

Advanced use

The following elements are added to the page so they can be altered as necessary:

body.themejs-active - applied when theme.js is supported
body.themejs - the alternative theme has been applied
div.themejs-back - background element, normally white
div.themejs-overlay - background overlay, normally white but can be changed

Any elements that should not be reversed - such as images - should have the CSS isolation: isolate; property applied, e.g.

img, svg { isolation: isolate; }

Version history

v1.0.1, 2 July 2019

toggled.js update

v1.0.0, 1 July 2019

initial release

Keywords

JavaScript

CSS

theme

FAQs

What is theme.js?

Is theme.js well maintained?

Package last updated on 02 Jul 2019

Did you know?

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install