Skip to content

SlashModule ​

This module provides a powerful block selection menu that appears when you type / (at the beginning of a line or after a space). It allows you to transform the current line or create a new block (Heading, List, Quote, Code, etc.) without leaving the keyboard.

Installation ​

The module is included in the bundle and registered automatically in the JavaScript controller. To use it, you only need to add it to your PHP form configuration.

Usage ​

php
use Ehyiah\QuillJsBundle\DTO\Modules\SlashModule;
use Ehyiah\QuillJsBundle\Form\QuillType;

$builder->add('content', QuillType::class, [
    'modules' => [
        new SlashModule(),
    ],
]);

Options ​

OptionTypeDescriptionDefault
(none currently)

Features Detail ​

Slash Menu ​

Type / to open the menu. You can then:

  • Use Heading 1, 2, or 3 to create titles.
  • Use Bullet List or Numbered List for lists.
  • Use Quote for blockquotes.
  • Use Code for code blocks.
  • Use Text to return to a normal paragraph.

Behavior:

  • If you type / at the start of an empty line, selecting an item transforms that line.
  • If you type / after some text, selecting an item creates a new line below with the chosen format, preserving what you already wrote.

Try it live ​

Type / in the editor below to open the slash command menu.

Visual Customization ​

The module injects its own CSS with a clean, modern aesthetic. You can override the styles in your own CSS using these classes:

  • .ql-slash-menu: The slash command menu container.
  • .ql-slash-menu .item: Individual items in the slash menu.
  • .ql-slash-menu .item-icon: Icon container for each item.
  • .ql-slash-menu .item-label: Label text for each item.
  • .ql-slash-menu .item-description: Description text for each item.