Notation Presets

A notation preset controls how quality suffixes are rendered — things like whether a minor-seventh chord reads m7 or MI⁷, and whether half-diminished reads ø or m7b5.

Built-in presets

The following presets are available without any registration:

• default — Unicode glyphs (♭ ♯ ø ° △)
• realbook — Real Book dialect (MI MA⁷ DIM. etc.)

How it works

Register a preset once using window.grigsonRegister.definePreset() (from grigson-register.iife.js — the same bundle the custom elements use):

window.grigsonRegister.definePreset('ascii', {
  halfDiminished: 'm7b5',
  diminished: 'dim',
  maj7: 'maj7',
});

Then reference it by name on <grigson-html-renderer>:

<grigson-chart normalise>
  <grigson-html-renderer notation-preset="ascii"></grigson-html-renderer>
  <template>...</template>
</grigson-chart>

The notation-preset attribute belongs to <grigson-html-renderer>, not <grigson-chart>. Multiple renderer children inside one <grigson-chart> each render the same parsed song independently:

<grigson-chart normalise>
  <grigson-html-renderer></grigson-html-renderer>
  <grigson-html-renderer notation-preset="ascii"></grigson-html-renderer>
  <template>...</template>
</grigson-chart>

Preset fields

Unspecified fields fall back to DEFAULT_PRESET. For the complete list of fields with their default values and descriptions, see the Notation Presets API reference (NotationPreset, DEFAULT_PRESET, REALBOOK_PRESET, definePreset, resolvePreset).