Skip to content

A web component for toggling dark mode that uses Shoelace buttons for consistent UI

License

Notifications You must be signed in to change notification settings

lalomartins/shoestring-theme-selector

Repository files navigation

Published on webcomponents.org NPM

<shoestring-theme-selector>

A web component for theme-selector that uses Shoelace buttons for consistent UI.

Written with Lit 3.0, but you can use it anywhere you can use Shoelace!

Usage

<shoestring-theme-selector></shoestring-theme-selector>

If you're using Shoelace in your own project and you want to avoid loading two different copies, import like this:

import '@shoelace-style/shoelace/dist/components/switch/switch.js';
import '@shoelace-style/shoelace/dist/components/icon/icon.js';
import '@lalomartins/shoestring-theme-selector/shoestring-theme-selector.js';

Otherwise, if you want to use the bundled Shoelace:

import {setBasePath} '@lalomartins/shoestring-theme-selector';
// …
setBasePath("node_modules/@lalomartins/shoestring-theme-selector/node_modules/@shoelace-style/shoelace/dist/");

(You can also use CDNed Shoelace if you prefer.)

API

Attributes:

  • size - Size to pass down to sl-switch

Slots:

If you provide contents (default slot), they will be used for the label; otherwise, <sl-icon name="moon" alt="Dark mode"></sl-icon>

Events:

  • theme-change - Indicates when the theme changes; event.detail.isDark is true when dark mode

Install

npm i @lalomartins/shoestring-theme-selector

You don't need to import Shoelace on your own code if you're not using it, but you do need to load your own CSS, whether it's from CDN, or from node_modules, or copying it into your build. You can check the Shoelace install instructions for details.

CDN

<link
  rel="stylesheet"
  href="https://cdn.jsdelivr.net/npm/@shoelace-style/shoelace@2.12.0/cdn/themes/light.css"
/>
<link
  rel="stylesheet"
  href="https://cdn.jsdelivr.net/npm/@shoelace-style/shoelace@2.12.0/cdn/themes/dark.css"
/>
<script
  type="module"
  src="https://cdn.jsdelivr.net/npm/@shoelace-style/shoelace@2.12.0/cdn/shoelace-autoloader.js"
></script>
<script
  type="module"
  src="https://cdn.jsdelivr.net/npm/@lalomartins/shoestring-theme-selector@1.0.1/cdn/shoestring-theme-selector.js"
></script>

If the icon doen't show up, tweak your import order to make sure you have the Shoelace base path set before Theme Selector loads.

About

A web component for toggling dark mode that uses Shoelace buttons for consistent UI

Resources

License

Stars

Watchers

Forks

Packages

No packages published