RichTextEditor
Редактор на TipTap. Єдиний компонент бібліотеки із зовнішніми залежностями.
Використати у своєму проєкті
Вихідний код, залежності та стилі. Без клонування Git.
Файли для перенесення · 21
- app/assets/css/components.css
- app/assets/css/theme.css
- app/assets/css/tokens.css
- app/assets/css/ui-prose.css
- app/components/ui/rich-text-editor/labels.ts
- app/components/ui/rich-text-editor/RteToolbar.vue
- app/components/ui/rich-text-editor/shared/icons.ts
- app/components/ui/rich-text-editor/shared/RteIcon.vue
- app/components/ui/rich-text-editor/shared/RteIconBtn.vue
- app/components/ui/UiDrawer.vue
- app/components/ui/UiProse.vue
- app/components/ui/UiRichTextEditor.vue
- app/composables/useFocusTrap.ts
- app/composables/useLazyTeleport.ts
- app/composables/useOverlayStack.ts
- app/composables/useReducedMotion.ts
- app/composables/useScrollEdges.ts
- app/composables/useScrollLock.ts
- app/composables/useUiText.ts
- app/utils/swipe.ts
- app/utils/uiFieldStyles.ts
Зовнішні пакети та версії вказані в JSON.
Підключення CSS та налаштування імпортів — в інструкції для агентів.
Це єдиний виняток із правила «бібліотека без зовнішніх залежностей». ProseMirror переписати неможливо, а редактор без нього — не редактор.
Залежності
Скопіювавши компонент, поставте:
bun add @tiptap/[email protected] @tiptap/[email protected] @tiptap/[email protected] @tiptap/[email protected] @tiptap/[email protected] @tiptap/[email protected] @tiptap/[email protected] @tiptap/[email protected] @tiptap/[email protected] @tiptap/[email protected] @tiptap/[email protected] @tiptap/[email protected] @tiptap/[email protected] @tiptap/[email protected] @floating-ui/dom
Версії точні, і це не педантизм. @tiptap/vue-3 пінує @tiptap/core та
@tiptap/pm точно, а решта сімейства залежить одне від одного через карет.
Варто зафіксувати лише частину — і решта поїде вперед: у нас extension-list
підтягнувся на 3.30.2, поки закріплений core лишався на 3.27.3, і імпорт
упав на відсутньому експорті. Додайте ще й overrides:
{ "overrides": { "@tiptap/core": "3.30.2", "@tiptap/pm": "3.30.2" } }
Дві копії ProseMirror у графі — найгірший зі сценаріїв: помилки не буде взагалі, просто всі команди мовчки перестануть працювати, бо схеми походитимуть з різних інстансів. Перевірка одним рядком:
find node_modules -type d -name prosemirror-model | wc -l
Чого в списку немає і чому: extension-link, -underline,
-horizontal-rule, -blockquote уже всередині starter-kit; -placeholder
і -character-count — у @tiptap/extensions; -color — у -text-style;
-table-row, -table-cell, -table-header — у -table. Поставити їх
окремо означає покласти в граф другу копію того самого розширення.
Приклад
Те саме через UiProse:
API
Props
| Назва | Тип | Типово | Опис |
|---|---|---|---|
ariaLabel | string | "Редактор тексту" | Доступна назва області редагування. |
placeholder | string | "Почніть писати…" | — |
mode | fullsimple | "full" | Набір можливостей. `simple` — лише текст, списки й заголовки; без таблиць і зображень. |
minHeight | string | "10rem" | Мінімальна висота поля, напр. `"12rem"`. |
modelValue | string | — | HTML-рядок. Використовуйте через `v-model`. |
labels | Partial<RteLabels> | — | Перекриття підписів. Задавайте лише ключі, що змінюються. У проєкті з i18n це один виклик замість 152: передайте об'єкт із `t()`, і зміна мови оновить підписи без перемонтування редактора. |
maxChars | number | — | Ліміт символів. Ввід понад ліміт відхиляється самим редактором, а не підсвічується постфактум. |
disabled | boolean | — | — |
readonly | boolean | — | Тільки читання, але з можливістю виділяти й копіювати. |
Події
| Назва | Payload | Опис |
|---|---|---|
update:modelValue | [value: string] | Новий HTML документа. Спрацьовує на кожну транзакцію. |
focus | [] | Редактор отримав фокус. |
blur | [] | Редактор втратив фокус. |
Слоти
| Назва | Опис |
|---|---|
toolbar | Панель інструментів. Поки не задано — рендериться типова. |
Доступно через ref
| Назва | Тип | Опис |
|---|---|---|
editor | Editor | Інстанс TipTap. Знадобиться для власних команд і розширень. |
focus | () => boolean | Ставить фокус у поле вводу. |
Коли використовувати
Для вмісту, який пишуть люди й читають люди: стаття, опис, довгий коментар.
Коли НЕ використовувати
Для короткого тексту без форматування беріть UiTextarea — 180 КБ заради
одного рядка не варті нічого.
Не використовуйте як редактор коду. Тут немає ні підсвітки синтаксису, ні відступів — для цього потрібен інший інструмент.
Чому немає ClientOnly
Перевірено, а не припущено: useEditor створює інстанс усередині
onMounted, а EditorContent на сервері рендерить порожній <div>. Тобто
надісланий HTML і перший клієнтський рендер збігаються, і гідрація чиста.
Обгортка в ClientOnly була б не лише зайвою, а й шкідливою: це специфіка
Nuxt, а бібліотеку копіюють і у Vite-проєкти.
Зв'язок із UiProse
Корінь ProseMirror несе клас ui-prose — той самий, що й UiProse. Це і
є контракт WYSIWYG: якби оформлення жило у scoped-стилях редактора,
публічній сторінці довелося б мати власну копію, і копії розійшлися б за
перший тиждень.
Тому ui-prose.css — обов'язкова залежність, а не рекомендація.