Style Menu
Last updated
Was this helpful?
Last updated
Was this helpful?
A Style Menu is a configurable extension that adds a cascading menu to the toolbar for applying text styles and formatting.
In this article, you can find an example of how to set up a Style Menu using the package manifest file.
The items
property defines the structure of the style menu. Each menu item has the following options:
label
: (required) The label of the menu item. This supports localization keys.
appearance
: This defines the appearance of the menu item. The value has 2 optional properties:
icon
: To prefix an icon to the menu item.
style
: To apply CSS rules to the menu item.
data
: To configure the function of the style menu item. The value has 3 optional properties:
tag
: A supported HTML tag name. This will be applied to the selected text.
class
: Applies a class attribute with the defined class name to the containing tag of the selected text.
id
: Applies an ID attribute with the defined ID value to the containing tag of the selected text.
separatorAfter
: When true
, it will add a line separator after the menu item.
items
: To enable a cascading menu, an array of nested menu items may be added.
Once configured, all custom style menus will appear in the Rich Text Editor toolbar options, as described in the Rich Text Editor Configuration article.
Since the Tiptap has a strict rich-text schema, only supported HTML tags can be used in the style menu, (arbitrary markup will be excluded). The following HTML tag names are supported:
h1
h2
h3
h4
h5
h6
p
blockquote
code
codeBlock
div
em
(italic)
ol
strong
(bold)
s
(strike-through)
span
u
(underline)
ul