Перейти к содержимому

Slash-команды ​

Slash-команды — это меню быстрой вставки, которое появляется, когда вы вводите / в начале строки.

Включение slash-команд ​

Slash-команды включены по умолчанию. Чтобы управлять ими явно:

vue
<template>
  <Tiptapify
    :slash-commands="true"
    placeholder="Type / to see available commands..."
  />
</template>

Доступные команды ​

Введите / в редакторе, чтобы увидеть палитру команд. Доступны, в частности, такие команды:

КомандаОписание
/h1 - /h6Вставить заголовок (уровни 1–6)
/bulletListВставить маркированный список
/numberedListВставить нумерованный список
/taskListВставить список задач
/codeВставить встроенный код
/codeBlockВставить блок кода
/quoteВставить цитату
/imageВставить изображение (откроет диалог URL)
/videoВстроить видео с YouTube
/tableВставить таблицу
/linkВставить гиперссылку
/dividerВставить горизонтальную линию
/emojiОткрыть выбор эмодзи
/specialCharsОткрыть специальные символы

Как это работает ​

  1. Поместите курсор в начало строки или после пробела
  2. Введите / — появится палитра команд
  3. Продолжайте вводить текст, чтобы отфильтровать команды
  4. Нажмите Enter или щёлкните, чтобы вставить выбранную команду

Отключение slash-команд ​

vue
<template>
  <Tiptapify
    :slash-commands="false"
    placeholder="Slash commands disabled..."
  />
</template>

Slash-команды с плавающим меню ​

Сочетайте slash-команды с плавающим меню для максимально удобного редактирования:

vue
<template>
  <Tiptapify
    :slash-commands="true"
    :floating-menu="true"
    :bubble-menu="true"
    placeholder="Full command experience..."
  />
</template>
  • Slash-команды (/) — вызываются вводом / в начале строки
  • Плавающее меню — появляется, когда курсор стоит на пустой строке (предлагает действия уровня блока)
  • Bubble-меню — появляется при выделении текста (предлагает встроенное форматирование)

Фильтрация доступных команд ​

Вы можете указать, какие команды включить, передав массив идентификаторов команд:

vue
<template>
  <Tiptapify
    :slash-commands="['h1', 'h2', 'h3', 'bulletList', 'numberedList', 'quote']"
    placeholder="Filtered commands..."
  />
</template>

Доступные идентификаторы команд ​

IDОписание
h1 - h6Заголовки уровней 1–6
bulletListМаркированный список
numberedListНумерованный список
taskListСписок задач
codeВстроенный код
codeBlockБлок кода
quoteЦитата
imageИзображение
videoВидео с YouTube
tableТаблица
linkСсылка
dividerГоризонтальная линия
emojiЭмодзи
specialCharsСпециальные символы

Выпущено под лицензией MIT.