Как вставить статью в чужой визуальный редактор из консоли: Editor.js, Lexical, Draft.js, TinyMCE, Tiptap, Quill

—

от автора

У нас маленькая компания из Петербурга, и свои статьи мы выкладываем примерно на полусотне площадок: от блогов и журналов до профильных сообществ. Текст готовим один раз в HTML, а дальше его надо вставить в чужой визуальный редактор. Руками копировать с форматированием быстро надоедает: где-то пропадают заголовки, где-то списки склеиваются в один абзац, картинки не грузятся вообще.

Поэтому вставку мы делаем из консоли браузера, в своей уже залогиненной вкладке. Ниже заметки по движкам, которые встретились чаще всего. Это не обход защит и не парсинг: тот же текст, который человек вставил бы через Ctrl+V, просто без ручной переразметки.

Главный приём: синтетический paste

Почти все современные редакторы слушают событие paste и сами превращают HTML из буфера в свои блоки. Значит, им можно отдать событие с нужным содержимым:

function pasteHtml(el, html) {  el.focus();  const dt = new DataTransfer();  dt.setData('text/html', html);  dt.setData('text/plain', html.replace(/<[^>]+>/g, ''));  el.dispatchEvent(new ClipboardEvent('paste', {    clipboardData: dt, bubbles: true, cancelable: true  }));}

Обязательно кладите и text/plain: часть редакторов смотрит сначала туда и при пустом значении молча ничего не делает. Дальше начинаются особенности каждого движка.

Editor.js

Встречался на трёх площадках. Абзацы, h2, маркированные и нумерованные списки из вставленного HTML он сохраняет. Вставлять нужно в пустой .ce-paragraph, а не в обёртку редактора.

Картинки из HTML Editor.js выбрасывает: тег img просто исчезает. Картинку грузим через инструмент Image. На пустом блоке жмём «+», выбираем «Изображение», появляется input[type=file], и в него подкладываем файл:

function putFile(input, file) {  const dt = new DataTransfer();  dt.items.add(file);  input.files = dt.files;  input.dispatchEvent(new Event('change', { bubbles: true }));}

Ещё одна мелочь: после списка курсор остаётся внутри него. Чтобы выйти в обычный абзац, нужно дважды нажать Enter, иначе следующий кусок текста станет пунктом списка.

Lexical

Вставка HTML работает, но у конкретной площадки свой маппинг: наш h2 превращался в H1. Площадка так задумала, спорить не стали.

Поле заголовка там отдельное, обычная textarea под управлением React. Если присвоить ей value из скрипта, React этого не увидит, и при отправке заголовок окажется пустым. Помогает настоящий ввод с клавиатуры, либо нативный сеттер:

const setter = Object.getOwnPropertyDescriptor(  HTMLTextAreaElement.prototype, 'value').set;setter.call(textarea, 'Заголовок');textarea.dispatchEvent(new Event('input', { bubbles: true }));

Картинка грузится через скрытый input[type=file] и встаёт туда, где стоит курсор. Курсор ставим через Selection в конец нужного абзаца перед загрузкой.

Draft.js

Самый капризный из списка. Синтетический paste без предварительного настоящего клика в тело редактора вставляет текст «невидимо»: в DOM его нет, а во внутреннем состоянии он есть. Повторная вставка после этого даёт дубль. Поэтому сначала реальный клик в конец текста, потом paste.

Вторая особенность: первый h2 во вставленном куске сливается с предыдущим абзацем. Лечится разрезанием по Enter и назначением заголовка кнопкой тулбара. Длинные тексты удобнее вставлять кусками по одному разделу.

TinyMCE

Тут paste не нужен вообще, у TinyMCE есть API:

const ed = tinymce.get('topic_text');ed.setContent(html);ed.fire('change');ed.save(); // переносит содержимое обратно в исходную textarea формы

Без save() форма уйдёт со старым содержимым textarea, это частая ошибка.

Интереснее с картинками в старой ветке 3.x. Диалог вставки изображения открывается во iframe, и туда не всегда можно напрямую загрузить файл средствами автоматизации. Сработал обходной путь: создаём временный input[type=file] в основном документе, загружаем файл в него, а потом переносим тот же File через DataTransfer в поле внутри iframe (документ того же origin, доступ есть).

Вставленная картинка у нас оказывалась ссылкой внутри последнего абзаца. Перенос в отдельный p через DOM редактора и повторный save() решают вопрос.

ProseMirror и Tiptap

У Tiptap удобная особенность: экземпляр редактора висит прямо на DOM-элементе. Можно не эмулировать буфер, а вызвать команду:

const el = document.querySelector('.tiptap.ProseMirror');el.editor.commands.focus();el.editor.commands.insertContent('<p>Текст</p>');

Если на странице несколько редакторов (например, основной и для ответов), отбирайте нужный по родителю, иначе текст уедет не туда.

Quill

На одной площадке картинки в Quill принимались только галереей над текстом и только перетаскиванием. Работает DragEvent('drop') с DataTransfer, в котором лежит File. Первая картинка становится обложкой, и порядок потом не меняется: если ошиблись, проще удалить и добавить заново.

Gutenberg

В редакторе WordPress картинку можно вставить как paste файла в пустой абзац: Gutenberg сам создаёт блок «Изображение» и загружает файл в медиатеку. Текст после этого вставляется обычным paste HTML под картинкой.

Модальные confirm и зависшие вкладки

На одной площадке кнопка публикации вызывала нативный window.confirm. Пока диалог открыт, вкладка не отвечает ни на какие команды извне. Решение простое: заранее подменить window.confirm = () => true и нажимать кнопку через setTimeout, чтобы вызов скрипта успел завершиться.

Что проверять после вставки

  • Количество заголовков и списков в DOM редактора совпадает с исходником.

  • Длина текста в innerText редактора примерно равна исходной. Если меньше вдвое, редактор что-то выкинул.

  • Нет дублей первого абзаца (привет, Draft.js).

  • Картинка встала в нужное место, а у обложки площадки, если она есть, стоит правильный флажок.

  • Поле заголовка действительно заполнено во внутреннем состоянии, а не только визуально.

Общий вывод для себя мы сделали такой: универсального способа нет, но почти везде хватает двух инструментов, синтетического paste и подкладывания File через DataTransfer. Всё остальное сводится к знанию, куда именно этот редактор хочет получить событие.

Если вы встречали редакторы, которые не принимают ни то, ни другое, напишите в комментариях, какие. Интересно собрать список.

ссылка на оригинал статьи https://habr.com/ru/articles/1109576/