High performance, self-hosted, newsletter and mailing list manager with a modern dashboard. Single binary app.
JavaScript campaigncampaign-managementemail-marketingemail-subscriptionlistmonkmailing-listnewsletternewsletter-managementnewsletter-softwareself-hostedsms-gatewaysmtptransactional-emails
// <richtext-editor> is a WebComponent wrapping Squire (squire-rte).
import Squire from 'squire-rte';
import { beautifyHTML } from './content.js';
import { setupTable } from './richtext/table.js';
import { toast } from './utils.js';
import {
i18n, t, closestInSelection, PALETTE, EMOJIS, CHARS,
} from './richtext/data.js';
const TRACK_SUFFIX = '@TrackLink';
const TRACK_KEY = 'trackLink';
// Simple toolbar toggles.
const TOGGLES = {
bold: ['B', 'bold', 'removeBold'],
italic: ['I', 'italic', 'removeItalic'],
underline: ['U', 'underline', 'removeUnderline'],
strikethrough: ['S', 'strikethrough', 'removeStrikethrough'],
subscript: ['SUB', 'subscript', 'removeSubscript'],
superscript: ['SUP', 'superscript', 'removeSuperscript'],
ul: ['UL', 'makeUnorderedList', 'removeList'],
ol: ['OL', 'makeOrderedList', 'removeList'],
};
const sanitizeToDOMFragment = (html) => {
const tpl = document.createElement('template');
tpl.innerHTML = html || '';
return document.importNode(tpl.content, true);
};
class RichtextEditor extends HTMLElement {
editor = null;
#source = null;
#toolbar = null;
#pending = null;
#mute = false;
#resizing = false;
#resizeObs = null;
#clearFind = null;
#refreshFind = null;
#mediaUpload = null;
connectedCallback() {
if (Object.hasOwn(this, 'value')) {
const v = this.value;
delete this.value;
this.value = v;
}
this.#source = this.querySelector('[data-rte-source]');
this.#toolbar = this.querySelector('.rte-toolbar');
this.content = this.querySelector('[data-rte-content]');
if (this.#source) {
this.#source.hidden = true;
}
this.content.setAttribute('spellcheck', 'true');
this.editor = new Squire(this.content, { blockTag: 'P', sanitizeToDOMFragment });
this.editor.setHTML(this.#source?.value ?? this.#pending ?? this.getAttribute('value') ?? '');
const disabled = this.hasAttribute('disabled');
if (disabled) {
this.content.setAttribute('contenteditable', 'false');
this.classList.add('is-disabled');
} else {
this.initToolbar();
this.initShortcuts();
this.#setupMediaPaste();
this.#setupFind();
this.#setupOverflow();
this.#fillGrids();
this.#setupColorInputs();
setupTable(this);
this.content.addEventListener('click', (e) => {
const el = e.target.closest('img, a[href]');
if (!el || !this.content.contains(el) || e.detail !== (el.matches('img') ? 2 : 3)) {
return;
}
e.preventDefault();
e.stopPropagation();
// Deselect Squire's image resizer before the dialog opens.
this.content.click();
const range = document.createRange();
range.selectNode(el);
this.editor.setSelection(range);
this.#run(el.matches('img') ? 'image' : 'link');
});
// Squire's getHTML() temporarily detaches its handles. Serialize after
// the drag ends so live input sync does not break its pointer capture.
this.content.addEventListener('gotpointercapture', (e) => {
if (e.target.matches('.squire-resize-handle')) {
this.#resizing = true;
}
});
this.content.addEventListener('lostpointercapture', () => {
if (this.#resizing) {
this.#resizing = false;
this.sync();
}
});
// Generic cancel buttons close their dialog.
this.querySelectorAll('[data-rte-act="cancel"]').forEach((b) => {
b.addEventListener('click', () => b.closest('dialog').close());
});
}
this.editor.addEventListener('input', () => this.sync());
this.editor.addEventListener('pathChange', () => this.#updateState());
this.editor.addEventListener('select', () => this.#updateState());
this.editor.addEventListener('undoStateChange', (e) => this.#updateUndo(e.detail));
this.#updateState();
this.#updateWordcount();
// Signal the host that the editor is initialized.
queueMicrotask(() => {
this.dispatchEvent(new CustomEvent('editor-ready', { bubbles: true }));
if (!disabled) {
this.editor.focus();
}
});
}
disconnectedCallback() {
this.#mediaUpload?.abort();
this.#clearFind?.();
this.#resizeObs?.disconnect();
this.#resizeObs = null;
this.editor?.destroy();
this.editor = null;
}
// Main value getter/setter.
get value() {
return this.editor
? this.editor.getHTML()
: (this.#pending ?? this.getAttribute('value') ?? '');
}
set value(val) {
const v = val == null ? '' : String(val);
if (!this.editor) {
this.#pending = v;
} else if (v !== this.editor.getHTML()) {
this.#mute = true;
this.editor.setHTML(v);
this.#mute = false;
this.#refreshFind?.();
this.#updateWordcount();
}
if (this.#source) {
this.#source.value = v;
}
}
// Push the current content to the host.
sync() {
if (!this.editor || this.#mute || this.#resizing) {
return;
}
if (this.#source) {
this.#source.value = this.editor.getHTML();
}
this.#updateWordcount();
this.dispatchEvent(new Event('input', { bubbles: true }));
}
// Toolbar.
initToolbar() {
// Keep the caret/selection in the editor when a toolbar control is pressed.
this.#toolbar.addEventListener('mousedown', (e) => {
if (e.target.closest('button')) {
e.preventDefault();
}
});
this.#toolbar.addEventListener('click', (e) => {
const btn = e.target.closest('[data-cmd]');
if (btn && this.#toolbar.contains(btn)) {
e.preventDefault();
this.#run(btn.dataset.cmd, btn.dataset.value);
}
});
}
#run(cmd, value) {
const ed = this.editor;
if (TOGGLES[cmd]) {
const [tag, on, off] = TOGGLES[cmd];
ed[ed.hasFormat(tag) ? off : on]();
} else {
switch (cmd) {
case 'undo': ed.undo(); break;
case 'redo': ed.redo(); break;
case 'fontsize': ed.setFontSize(value); break;
case 'forecolor': ed.setTextColor(value || ''); break;
case 'backcolor': ed.setHighlightColor(value || ''); break;
case 'block': this.#setBlock(value); break;
case 'align': ed.setTextAlignment(value); break;
case 'indent': this.#indent('increase'); break;
case 'outdent': this.#indent('decrease'); break;
case 'hr': ed.insertHTML('<hr>'); break;
case 'removeformat': ed.removeAllFormatting(); break;
case 'link': this.#openLink(); break;
case 'anchor': this.#insertAnchor(); break;
case 'image': this.#openImage(); break;
case 'fullscreen': this.classList.toggle('is-fullscreen'); break;
case 'help': this.#dialog('help').showModal(); break;
case 'source':
case 'insert-html':
this.#openCode(cmd);
return;
default: break;
}
}
// Table/charmap/emoji/find are native popovers.
this.#closePopovers();
}
// Block-level formatting.
#setBlock(tag) {
const ed = this.editor;
if (tag === 'BLOCKQUOTE') {
if (!ed.hasFormat('BLOCKQUOTE')) {
ed.increaseQuoteLevel();
}
return;
}
if (tag === 'PRE') {
ed[ed.hasFormat('PRE') ? 'removeCode' : 'code']();
return;
}
const rename = (node) => {
for (const child of [...node.childNodes]) {
if (!/^(?:P|DIV|H[1-6]|BLOCKQUOTE|PRE)$/.test(child.nodeName)) {
rename(child);
continue;
}
const el = document.createElement(tag);
for (const attr of ['style', 'dir']) {
if (child.hasAttribute(attr)) {
el.setAttribute(attr, child.getAttribute(attr));
}
}
el.append(...child.childNodes);
child.replaceWith(el);
}
};
ed.modifyBlocks((frag) => {
rename(frag);
return frag;
});
}
// Indent/outdent.
#indent(dir) {
const ed = this.editor;
const inList = /[OU]L>/.test(ed.getPath()) || ed.hasFormat('LI');
ed[dir + (inList ? 'ListLevel' : 'QuoteLevel')]();
}
// Active-state.
#updateState() {
const ed = this.editor;
const path = ed.getPath() || '';
for (const btn of this.#toolbar.querySelectorAll('[data-format]')) {
btn.classList.toggle('is-active', ed.hasFormat(btn.dataset.format));
}
// Colour buttons.
const font = ed.getFontInfo();
this.#toolbar.querySelector('[popovertarget="rte-forecolor"]')?.classList.toggle('is-active', !!font.color);
this.#toolbar.querySelector('[popovertarget="rte-backcolor"]')?.classList.toggle('is-active', !!font.backgroundColor);
// Link / image.
this.#toolbar.querySelector('[data-cmd="link"]')
?.classList.toggle('is-active', !!closestInSelection(ed, this.content, 'a[href]'));
this.#toolbar.querySelector('[data-cmd="image"]')
?.classList.toggle('is-active', !!closestInSelection(ed, this.content, 'img'));
// Alignment.
const align = this.getAlign();
for (const btn of this.#toolbar.querySelectorAll('[data-cmd="align"]')) {
btn.classList.toggle('is-active', btn.dataset.value === align);
}
// Block-format label.
const m = path.match(/(H[1-6]|BLOCKQUOTE|PRE)/);
this.#toolbar.querySelector('[data-rte-blocklabel]').textContent = !m
? t('editor.paragraph')
: ({ BLOCKQUOTE: t('editor.blockquote'), PRE: t('globals.terms.code') })[m[1]]
?? `${t('editor.heading')} ${m[1][1]}`;
// Statusbar element path.
this.querySelector('[data-rte-path]').textContent = path.replace(/^(?:P|DIV)>?/, '').replace(/>/g, ' › ').toLowerCase();
}
// Get the explicit alignment.
getAlign() {
const range = this.editor.getSelection();
let node = range?.commonAncestorContainer;
if (node?.nodeType === 3) {
node = node.parentNode;
}
const block = node?.nodeType === 1
? node.closest('p, div, li, h1, h2, h3, h4, h5, h6, blockquote, pre, td, th') : null;
if (!block || !this.content.contains(block)) {
return '';
}
const val = block.style.textAlign;
return { start: 'left', end: 'right' }[val] ?? val;
}
#updateUndo({ canUndo, canRedo }) {
this.#toolbar.querySelector('[data-cmd="undo"]').disabled = !canUndo;
this.#toolbar.querySelector('[data-cmd="redo"]').disabled = !canRedo;
}
#updateWordcount() {
const range = document.createRange();
range.selectNodeContents(this.content);
const text = this.editor.getSelectedText(range).trim();
const n = text ? text.split(/\s+/).length : 0;
this.querySelector('[data-rte-wordcount]').textContent = i18n.tc('editor.words', n, { num: n });
}
// Responsive toolbar
#setupOverflow() {
const bar = this.#toolbar;
const overflow = bar.querySelector('.rte-overflow');
const menu = overflow.querySelector('.rte-overflow-menu');
const groups = [...bar.querySelectorAll(':scope > .rte-group')];
const reflow = () => {
// Restore every group to the bar and measure against a single line.
groups.forEach((g) => bar.insertBefore(g, overflow));
overflow.hidden = true;
if (bar.scrollWidth <= bar.clientWidth) {
return;
}
// Show the control on overflolw.
overflow.hidden = false;
overflow.style.marginInlineStart = '0';
for (let i = groups.length - 1; i >= 0 && bar.scrollWidth > bar.clientWidth; i -= 1) {
menu.insertBefore(groups[i], menu.firstChild);
}
overflow.style.marginInlineStart = '';
};
this.#resizeObs = new ResizeObserver(() => window.requestAnimationFrame(reflow));
this.#resizeObs.observe(bar);
reflow();
}
// Dialogs.
#dialog(name) {
return this.querySelector(`[data-rte-dialog="${name}"]`);
}
#closePopovers() {
this.querySelectorAll('.rte-menu:popover-open, .rte-colors:popover-open').forEach((m) => m.hidePopover());
}
// Link dialog.
#openLink() {
const ed = this.editor;
const d = this.#dialog('link');
const f = d.querySelector('form');
const sel = ed.getSelectedText();
const a = closestInSelection(ed, this.content, 'a');
// Pre-fill value from an existing link under the cursor?
const href = a?.getAttribute('href') ?? '';
const tracked = href.endsWith(TRACK_SUFFIX);
f.url.value = tracked ? href.slice(0, -TRACK_SUFFIX.length) : href;
f.text.value = a ? a.textContent : sel;
f.title.value = a?.getAttribute('title') ?? '';
f.track.checked = a ? tracked : localStorage.getItem(TRACK_KEY) === 'true';
d.querySelector('[data-rte-act="submit"]').onclick = () => {
let url = f.url.value.trim();
if (!url) {
d.close();
return;
}
localStorage.setItem(TRACK_KEY, f.track.checked);
if (f.track.checked && /^https?:\/\//i.test(url)) {
url += TRACK_SUFFIX;
}
const attrs = {};
if (f.title.value.trim()) {
attrs.title = f.title.value.trim();
}
ed.focus();
const label = f.text.value.trim();
if (a) {
const range = document.createRange();
range.selectNode(a);
ed.setSelection(range);
ed.makeLink(url, attrs);
} else if (label && !sel) {
// Nothing selected, so insert a new labelled link.
const el = Object.assign(document.createElement('a'), { textContent: label });
el.setAttribute('href', url);
Object.entries(attrs).forEach(([k, v]) => el.setAttribute(k, v));
ed.insertHTML(el.outerHTML);
} else {
ed.makeLink(url, attrs);
}
d.close();
};
d.querySelector('[data-rte-act="unlink"]').onclick = () => {
ed.focus();
ed.removeLink();
d.close();
};
d.showModal();
f.url.focus();
}
#insertAnchor() {
const name = window.prompt(t('editor.anchorName'));
if (name) {
this.editor.focus();
this.editor.insertHTML(`<a id="${name.replace(/"/g, '')}"></a>`);
}
}
// Capture pasted files and data-URI images, upload them to the server,
// then insert them into the editor (images) or add as attachments (non-images).
#setupMediaPaste() {
// Capture before Squire handles mixed image/file clipboard contents.
this.addEventListener('paste', (e) => {
const files = [...(e.clipboardData?.files || [])];
if (!this.content.contains(e.target) || !this.hasAttribute('allow-attachments')
|| !files.some((file) => !file.type.startsWith('image/'))) {
return;
}
e.preventDefault();
e.stopImmediatePropagation();
this.#pasteMedia(document.createDocumentFragment(), files);
}, true);
this.editor.addEventListener('pasteImage', (e) => {
const files = [...e.detail.clipboardData.files].filter((file) => file.type.startsWith('image/'));
if (!files.length) {
return;
}
this.#pasteMedia(document.createDocumentFragment(), files);
});
this.editor.addEventListener('willPaste', (e) => {
const fragment = e.detail.fragment;
if (fragment?.querySelector('img[src^="data:image/"]')) {
e.preventDefault();
this.#pasteMedia(fragment);
}
});
}
async #pasteMedia(fragment, files = []) {
if (this.inert) {
return;
}
const ed = this.editor;
const range = ed.getSelection().cloneRange();
const uploads = files.length ? files.map((file) => {
const img = file.type.startsWith('image/') ? document.createElement('img') : null;
if (img) {
fragment.append(img);
}
return [img, file];
}) : [...fragment.querySelectorAll('img[src^="data:image/"]')].map((img) => [img, null]);
const controller = new AbortController();
const { signal } = controller;
this.#mediaUpload = controller;
const cancel = (e) => {
if (e.key === 'Escape') {
e.preventDefault();
e.stopPropagation();
controller.abort();
}
};
// The editor is disabled/locked during uploads, so listen outside it.
document.addEventListener('keydown', cancel, true);
this.setAttribute('data-spinner', 'overlay');
this.setAttribute('aria-busy', 'true');
this.inert = true;
try {
for (const [img, file] of uploads) {
const blob = file || await (await fetch(img.src, { signal })).blob();
signal.throwIfAborted();
const body = new FormData();
body.set('file', blob, blob.name || `image.${blob.type.split('/')[1].split('+')[0]}`);
const resp = await fetch('/api/media', {
method: 'POST', body, signal, headers: { Accept: 'application/json' },
});
if (!resp.ok) {
const out = await resp.json().catch(() => ({}));
throw new Error(out.message || resp.statusText);
}
const out = await resp.json();
signal.throwIfAborted();
if (img) {
img.setAttribute('src', out.data.url);
img.removeAttribute('srcset');
} else if (this.editor === ed) {
this.dispatchEvent(new CustomEvent('richtext-attachment', { bubbles: true, detail: out.data }));
}
}
signal.throwIfAborted();
if (this.editor === ed && fragment.hasChildNodes()) {
const holder = document.createElement('div');
holder.append(fragment);
ed.setSelection(range);
ed.insertHTML(holder.innerHTML);
}
} catch (err) {
if (!signal.aborted) {
toast(err.message, 'danger');
}
} finally {
document.removeEventListener('keydown', cancel, true);
this.#mediaUpload = null;
this.inert = false;
this.removeAttribute('aria-busy');
if (this.editor === ed) {
ed.focus();
}
}
}
// Image dialog.
#openImage() {
const ed = this.editor;
const d = this.#dialog('image');
const f = d.querySelector('form');
const img = closestInSelection(ed, this.content, 'img');
f.src.value = img?.getAttribute('src') ?? '';
f.alt.value = img?.getAttribute('alt') ?? '';
f.width.value = img ? Math.round(img.getBoundingClientRect().width) || '' : '';
f.height.value = img ? Math.round(img.getBoundingClientRect().height) || '' : '';
f.float.value = (img && ['img-float-left', 'img-float-right'].find((c) => img.classList.contains(c))) || '';
f.embed.checked = img?.hasAttribute('data-embed') ?? false;
// Constrain-proportions lock.
const lock = d.querySelector('[data-rte-act="lock"]');
const locked = () => lock.getAttribute('aria-pressed') === 'true';
const rat = (w, h) => (w > 0 && h > 0 ? w / h : null);
let ratio = rat(Number(f.width.value), Number(f.height.value))
|| (img && rat(img.naturalWidth, img.naturalHeight));
let lastDimension = 'width';
let request = 0;
const scale = () => {
const from = f.elements[lastDimension];
const to = f.elements[lastDimension === 'width' ? 'height' : 'width'];
const v = Number(from.value);
if (locked() && ratio && Number.isFinite(v) && v > 0) {
to.value = Math.max(1, Math.round(lastDimension === 'width' ? v / ratio : v * ratio));
}
};
// Get the ratio from an image's actual size.
const loadRatio = (src) => {
const id = ++request;
if (src) {
const probe = new Image();
probe.onload = () => {
if (id !== request) {
return;
}
ratio = rat(probe.naturalWidth, probe.naturalHeight);
scale();
};
probe.src = src;
}
};
d.addEventListener('close', () => { request += 1; }, { once: true });
if (!ratio) {
loadRatio(f.src.value.trim());
}
f.src.oninput = () => {
ratio = null;
loadRatio(f.src.value.trim());
};
f.width.oninput = () => {
lastDimension = 'width';
scale();
};
f.height.oninput = () => {
lastDimension = 'height';
scale();
};
lock.onclick = () => {
const on = !locked();
lock.setAttribute('aria-pressed', on);
lock.classList.toggle('is-active', on);
const use = lock.querySelector('use');
use.setAttribute('href', `${(use.getAttribute('href') || '').split('#')[0]}#icon-${on ? 'lock' : 'unlock'}`);
scale();
};
d.querySelector('[data-rte-act="browse"]').onclick = () => {
this.dispatchEvent(new CustomEvent('richtext-media', {
bubbles: true,
detail: {
cb: (url) => {
f.src.value = url;
ratio = null;
loadRatio(url);
},
},
}));
};
d.querySelector('[data-rte-act="submit"]').onclick = () => {
if (!f.reportValidity()) {
return;
}
const src = f.src.value.trim();
if (!src) {
d.close();
return;
}
const attrs = Object.fromEntries([
['alt', f.alt.value.trim()],
['width', f.width.value.trim()],
['height', f.height.value.trim()],
['class', f.float.value],
['data-embed', f.embed.checked ? 'true' : ''],
].filter(([, v]) => v));
ed.focus();
if (img) {
// Update the existing image in place.
ed.saveUndoState();
img.setAttribute('src', src);
for (const k of ['alt', 'width', 'height', 'data-embed']) {
if (attrs[k]) {
img.setAttribute(k, attrs[k]);
} else {
img.removeAttribute(k);
}
}
img.style.removeProperty('width');
img.style.removeProperty('height');
// Only replace the float classes managed by this dialog.
img.classList.remove('img-float-left', 'img-float-right');
if (f.float.value) {
img.classList.add(f.float.value);
}
this.sync();
} else {
ed.insertImage(src, attrs);
}
d.close();
};
d.showModal();
f.src.focus();
}
// Source and 'Insert HTML' dialogs share a CodeMirror <code-editor>.
#openCode(name) {
const d = this.#dialog(name);
const body = d.querySelector('[data-rte-code]');
const code = document.createElement('code-editor');
code.setAttribute('lang', 'html');
const ta = document.createElement('textarea');
ta.value = name === 'source' ? beautifyHTML(this.editor.getHTML()) : '';
code.append(ta);
body.replaceChildren(code);
d.querySelector('[data-rte-act="format"]').onclick = () => {
code.value = beautifyHTML(code.value);
};
d.querySelector('[data-rte-act="submit"]').onclick = () => {
this.editor.focus();
if (name === 'source') {
this.value = code.value;
this.sync();
} else {
this.editor.insertHTML(code.value);
}
d.close();
};
d.addEventListener('close', () => body.replaceChildren(), { once: true });
d.showModal();
}
// Find and replace.
#setupFind() {
const panel = this.querySelector('[data-rte-find]');
const f = (n) => panel.querySelector(`[name="${n}"]`);
const count = panel.querySelector('[data-rte-findcount]');
let matches = [];
let idx = -1;
const highlights = ['rte-find', 'rte-find-current'].map((name, priority) => {
if (!CSS.highlights.has(name)) {
const highlight = new Highlight();
highlight.priority = priority;
CSS.highlights.set(name, highlight);
}
return CSS.highlights.get(name);
});
const clear = () => {
for (const range of matches) {
highlights.forEach((highlight) => highlight.delete(range));
}
matches = [];
};
this.#clearFind = clear;
const showCurrent = (scroll) => {
const range = matches[idx];
if (range) {
highlights[1].add(range);
if (scroll) {
range.startContainer.parentElement.scrollIntoView({ block: 'center' });
}
}
};
const next = () => {
if (!matches.length) {
return;
}
highlights[1].delete(matches[idx]);
idx = (idx + 1) % matches.length;
showCurrent(true);
};
const doFind = (scroll = true) => {
clear();
const term = f('find').value;
if (!term) {
idx = -1;
count.textContent = '';
return;
}
const re = new RegExp(term.replace(/[.*+?^${}()|[\]\\]/g, '\\$&'), f('matchcase').checked ? 'g' : 'gi');
const walker = document.createTreeWalker(this.content, NodeFilter.SHOW_TEXT);
while (walker.nextNode()) {
const node = walker.currentNode;
for (const match of node.data.matchAll(re)) {
const range = document.createRange();
range.setStart(node, match.index);
range.setEnd(node, match.index + match[0].length);
matches.push(range);
highlights[0].add(range);
}
}
idx = scroll ? 0 : Math.max(0, Math.min(idx, matches.length - 1));
count.textContent = i18n.ts('editor.findCount', { num: matches.length });
showCurrent(scroll);
};
this.#refreshFind = () => {
if (panel.matches(':popover-open')) {
doFind(false);
} else {
clear();
}
};
this.editor.addEventListener('input', this.#refreshFind);
const replaceOne = () => {
if (!matches[idx]) {
doFind();
return;
}
this.editor.setSelection(matches[idx]);
this.editor.insertPlainText(f('replace').value, false);
};
const replaceAll = () => {
if (!matches.length) {
return;
}
this.editor.saveUndoState();
doFind(false);
for (const range of [...matches].reverse()) {
range.deleteContents();
range.insertNode(document.createTextNode(f('replace').value));
}
};
f('find').addEventListener('input', doFind);
f('matchcase').addEventListener('change', doFind);
f('find').addEventListener('keydown', (e) => {
if (e.key === 'Enter') {
e.preventDefault();
next();
}
});
panel.querySelector('[data-rte-act="next"]').addEventListener('click', next);
panel.querySelector('[data-rte-act="replace"]').addEventListener('click', replaceOne);
panel.querySelector('[data-rte-act="replaceAll"]').addEventListener('click', replaceAll);
// Focus the input on open.
panel.addEventListener('toggle', (e) => {
if (e.newState === 'open') {
setTimeout(() => f('find').focus(), 0);
if (f('find').value) {
doFind();
}
} else {
clear();
}
});
}
// Colour / emoji / char grids.
#fillGrids() {
// Colour swatch palettes.
for (const menu of this.querySelectorAll('[data-rte-palette]')) {
for (const c of [...PALETTE, '']) {
const b = Object.assign(document.createElement('button'), {
type: 'button',
className: c ? 'rte-swatch' : 'rte-swatch rte-swatch-none',
title: c || t('globals.terms.none'),
textContent: c ? '' : '×',
});
Object.assign(b.dataset, { cmd: menu.dataset.rtePalette, value: c });
b.style.background = c;
menu.append(b);
}
}
// Special character and emoji grids.
for (const [holder, glyphs] of [['[data-rte-charmap]', CHARS], ['[data-rte-emoji]', EMOJIS]]) {
const grid = this.querySelector(holder);
for (const ch of glyphs) {
const b = Object.assign(document.createElement('button'), {
type: 'button', className: 'ghost rte-glyph', textContent: ch,
});
// Keep the popover open so multiple glyphs can be inserted in sequence.
b.addEventListener('click', () => {
this.editor.focus();
this.editor.insertPlainText(ch, false);
});
grid.append(b);
}
}
}
// Manual hex entry + native colour picker in the colour popovers.
#setupColorInputs() {
const norm = (v) => {
const s = v.trim().replace(/^#?/, '');
return /^([0-9a-fA-F]{3}|[0-9a-fA-F]{6})$/.test(s) ? `#${s}` : null;
};
// Convert rgb to hex.
const toHex = (rgb) => {
const m = rgb?.match(/\d+/g);
if (!m || m.length < 3) {
return null;
}
return `#${m.slice(0, 3).map((n) => Number(n).toString(16).padStart(2, '0')).join('')}`;
};
for (const row of this.querySelectorAll('[data-rte-colorinput]')) {
const cmd = row.dataset.rteColorinput;
const picker = row.querySelector('input[name="picker"]');
const hex = row.querySelector('input[name="hex"]');
// On open, set colour of the selected item.
row.closest('[popover]').addEventListener('toggle', (e) => {
if (e.newState !== 'open') {
return;
}
const font = this.editor.getFontInfo();
const cur = toHex(cmd === 'forecolor' ? font.color : font.backgroundColor);
hex.value = cur ?? '';
if (cur) {
picker.value = cur;
}
});
// Picker to hex.
picker.addEventListener('input', () => { hex.value = picker.value; });
// Hex to picker (preview).
hex.addEventListener('input', () => {
const c = norm(hex.value);
if (c) {
picker.value = c;
}
});
const apply = () => {
const c = norm(hex.value) ?? picker.value;
this.#run(cmd, c);
};
row.querySelector('[data-rte-act="applycolor"]').addEventListener('click', apply);
hex.addEventListener('keydown', (e) => {
if (e.key === 'Enter') {
e.preventDefault();
apply();
}
});
}
}
// Shortcuts.
initShortcuts() {
const emit = (name) => (self, e) => {
e.preventDefault();
e.stopPropagation();
this.dispatchEvent(new CustomEvent(name, { bubbles: true }));
};
const link = (self, e) => {
e.preventDefault();
this.#openLink();
};
const keys = {
'Ctrl-s': emit('campaign-save'),
'Meta-s': emit('campaign-save'),
F9: emit('campaign-preview'),
'Ctrl-k': link,
'Meta-k': link,
// Squire handles both keys; add a trailing BR when its line break
// would otherwise leave no visible line for the caret (including TDs).
Enter: (self, e) => this.#splitBlock(self, e),
'Shift-Enter': (self, e) => this.#splitBlock(self, e),
};
Object.entries(keys).forEach(([key, fn]) => this.editor.setKeyHandler(key, fn));
}
// Delegate splitting to Squire, then keep a trailing line break visible.
#splitBlock(ed, e) {
e.preventDefault();
ed.splitBlock(e.shiftKey);
const range = ed.getSelection();
if (!range?.collapsed) {
return;
}
const { startContainer: node, startOffset } = range;
const br = node.nodeType === 1 ? node.childNodes[startOffset - 1]
: (startOffset === 0 ? node.previousSibling : null);
if (br?.nodeName === 'BR' && !br.nextSibling) {
br.after(document.createElement('br'));
}
}
}
if (!customElements.get('richtext-editor')) {
customElements.define('richtext-editor', RichtextEditor);
}