Skip to main content
Home
Browse packagesDocsSign in

@musodojo/enharmonic-note-selector@8.1.0
Built and signed on GitHub Actions

latest
conor-dowdall/enharmonic-note-selector

A web component for selecting common spellings of enharmonic notes and dispatching an event with the selected note's name and integer.

This package works with Node.js, Deno, BrowsersIt is unknown whether this package works with Cloudflare Workers, Bun
It is unknown whether this package works with Cloudflare Workers
This package works with Node.js
This package works with Deno
It is unknown whether this package works with Bun
This package works with Browsers
JSR Score
100%
Published
2 days ago (8.1.0)

Enharmonic Note Selector Web Component

enharmonic-note-selector is a custom HTML element that allows users to select a musical note (e.g., "C", "B♯", "D♯", "E♭") from a dialog and dispatch a custom event.

  • displays a button which opens a dialog containing all enharmonic equivalents for each pitch, including up to double sharps and flats.
  • ability to limit choice to common root notes only.
  • dispatches an event with the note name and note integer in the details.

npm version npm downloads JSR score

Bundle

Create the dist/bundle.js file for the example

Deno

deno task bundle

Node

npm run bundle

See examples/example1.html

<!DOCTYPE html>
<html lang="en">
  <head>
    <meta charset="UTF-8" />
    <title>Simple Enharmonic Note Selector Example</title>
    <script type="module" src="../dist/bundle.js"></script>
  </head>
  <body>
    <h1>Enharmonic Note Selector</h1>
    <enharmonic-note-selector
      selected-note-name="C♯"
    ></enharmonic-note-selector>

    <script type="module">
      const selector = document.querySelector(
        "enharmonic-note-selector",
      );

      selector.addEventListener("enharmonic-note-selected", (e) => {
        console.log("Note name:", e.detail.noteName);
        console.log("Note integer:", e.detail.noteInteger);
      });
    </script>
  </body>
</html>

Features

  • Enharmonic Note Selection: Provides a user-friendly interface for choosing a specific enharmonic spelling.
  • Customizable Appearance: Supports theming via CSS custom properties and slots. You can set a background color for each note pitch, and the component will automatically calculate a high-contrast text color.
  • Event Handling: Dispatches an enharmonic-note-selected event when the user makes a selection, providing the selected note name and note integer.
  • Attributes and Properties:
    • selected-note-name attribute: Sets the initially selected note name.
    • selectedNoteName property: Gets or sets the selected note name.
    • selectedNoteInteger property (read-only): Gets the integer representation of the selected note (0-11).
    • noteColorGroup property: Sets an array of 12 color strings for theming.
    • root-notes-only attribute: A boolean attribute that, when present, restricts the selection to only standard root notes.
  • Random Selection: Includes a public method to programmatically select a random note.

Styling with CSS Custom Properties

The component's appearance can be customized in several ways.

Customizing Icons with Slots

You can replace the default icons for the main button and the close button using HTML slots.

  • Main Button Icon: Provide an element (like an <img> or <svg> or even <p>Choose A Note</p>) directly inside the <enharmonic-note-selector> tag. This will replace the default musical note icon that appears when no note is selected.

  • Close Button Icon: To replace the 'X' icon in the dialog, add an element with the attribute slot="close-dialog-icon".

<enharmonic-note-selector>
  <!-- This SVG replaces the default main button icon -->
  <svg><!-- your custom svg --></svg>

  <!-- This SVG replaces the default close icon in the dialog -->
  <svg slot="close-dialog-icon"><!-- your custom svg --></svg>
</enharmonic-note-selector>

Sizing and Padding using ::part()

The main button inside the component is exposed via a shadow part named main-button. This allows you to directly style its padding, font, and other properties from your global stylesheet. This is the recommended way to control the component's size and internal spacing.

enharmonic-note-selector::part(main-button) {
  border: 1px solid currentColor;
  border-radius: 0.6em;
  padding: 0.3em 1em;
}

enharmonic-note-selector::part(main-button):hover {
  background-color: color-mix(in srgb, currentColor 20%, transparent 80%);
}

Adding Note Colors

You can set a background color for each of the 12 note pitches using CSS custom properties or the noteColorGroup JavaScript property. The component will automatically calculate and apply a high-contrast text color (black or white) to ensure readability.

The available properties are --note-color-0 through --note-color-11.

  • --note-color-0: Color for pitch 0 (C, B♯, D♭♭)
  • --note-color-1: Color for pitch 1 (C♯, D♭)
  • ...and so on for all 12 pitches.

You can set these in your CSS:

enharmonic-note-selector {
  --note-color-0: #ff0000; /* Red for C */
  --note-color-1: #ff7f00; /* Orange for C# */
  --note-color-2: #ffff00; /* Yellow for D */
  /* ... etc. */
}
Built and signed on
GitHub Actions
View transparency log

New Ticket: Report package

Please provide a reason for reporting this package. We will review your report and take appropriate action.

Please review the JSR usage policy before submitting a report.

Add Package

deno add jsr:@musodojo/enharmonic-note-selector

Import symbol

import * as enharmonic_note_selector from "@musodojo/enharmonic-note-selector";
or

Import directly with a jsr specifier

import * as enharmonic_note_selector from "jsr:@musodojo/enharmonic-note-selector";

Add Package

pnpm i jsr:@musodojo/enharmonic-note-selector
or (using pnpm 10.8 or older)
pnpm dlx jsr add @musodojo/enharmonic-note-selector

Import symbol

import * as enharmonic_note_selector from "@musodojo/enharmonic-note-selector";

Add Package

yarn add jsr:@musodojo/enharmonic-note-selector
or (using Yarn 4.8 or older)
yarn dlx jsr add @musodojo/enharmonic-note-selector

Import symbol

import * as enharmonic_note_selector from "@musodojo/enharmonic-note-selector";

Add Package

vlt install jsr:@musodojo/enharmonic-note-selector

Import symbol

import * as enharmonic_note_selector from "@musodojo/enharmonic-note-selector";

Add Package

npx jsr add @musodojo/enharmonic-note-selector

Import symbol

import * as enharmonic_note_selector from "@musodojo/enharmonic-note-selector";

Add Package

bunx jsr add @musodojo/enharmonic-note-selector

Import symbol

import * as enharmonic_note_selector from "@musodojo/enharmonic-note-selector";