mirror of
https://github.com/ueberdosis/tiptap.git
synced 2024-12-19 05:37:51 +08:00
f387ad3dd4
* chore:(core): migrate to tsup * chore: migrate blockquote and bold to tsup * chore: migrated bubble-menu and bullet-list to tsup * chore: migrated more packages to tsup * chore: migrate code and character extensions to tsup * chore: update package.json to simplify build for all packages * chore: move all packages to tsup as a build process * chore: change ci build task * feat(pm): add prosemirror meta package * rfix: resolve issues with build paths & export mappings * docs: update documentation to include notes for @tiptap/pm * chore(pm): update tsconfig * chore(packages): update packages * fix(pm): add package export infos & fix dependencies * chore(general): start moving to pm package as deps * chore: move to tiptap pm package internally * fix(demos): fix demos working with new pm package * fix(tables): fix tables package * fix(tables): fix tables package * chore(demos): pinned typescript version * chore: remove unnecessary tsconfig * chore: fix netlify build * fix(demos): fix package resolving for pm packages * fix(tests): fix package resolving for pm packages * fix(tests): fix package resolving for pm packages * chore(tests): fix tests not running correctly after pm package * chore(pm): add files to files array * chore: update build workflow * chore(tests): increase timeout time back to 12s * chore(docs): update docs * chore(docs): update installation guides & pm information to docs * chore(docs): add link to prosemirror docs * fix(vue-3): add missing build step * chore(docs): comment out cdn link * chore(docs): remove semicolons from docs * chore(docs): remove unnecessary installation note * chore(docs): remove unnecessary installation note
130 lines
3.4 KiB
Markdown
130 lines
3.4 KiB
Markdown
---
|
|
description: Add a toolbar that pops up above the text. Great to apply inline formatting.
|
|
icon: chat-2-line
|
|
---
|
|
|
|
# Bubble Menu
|
|
[](https://www.npmjs.com/package/@tiptap/extension-bubble-menu)
|
|
[](https://npmcharts.com/compare/@tiptap/extension-bubble-menu?minimal=true)
|
|
|
|
This extension will make a contextual menu appear near a selection of text. Use it to let users apply [marks](/api/marks) to their text selection.
|
|
|
|
As always, the markup and styling is totally up to you.
|
|
|
|
## Installation
|
|
```bash
|
|
npm install @tiptap/extension-bubble-menu
|
|
```
|
|
|
|
## Settings
|
|
|
|
### element
|
|
The DOM element that contains your menu.
|
|
|
|
Type: `HTMLElement`
|
|
|
|
Default: `null`
|
|
|
|
### updateDelay
|
|
The `BubbleMenu` debounces the `update` method to allow the bubble menu to not be updated on every selection update. This can be controlled in milliseconds.
|
|
The BubbleMenuPlugin will come with a default delay of 250ms. This can be deactivated, by setting the delay to `0` which deactivates the debounce.
|
|
|
|
Type: `Number`
|
|
|
|
Default: `undefined`
|
|
|
|
### tippyOptions
|
|
Under the hood, the `BubbleMenu` uses [tippy.js](https://atomiks.github.io/tippyjs/v6/all-props/). You can directly pass options to it.
|
|
|
|
Type: `Object`
|
|
|
|
Default: `{}`
|
|
|
|
### pluginKey
|
|
The key for the underlying ProseMirror plugin. Make sure to use different keys if you add more than one instance.
|
|
|
|
Type: `string | PluginKey`
|
|
|
|
Default: `'bubbleMenu'`
|
|
|
|
### shouldShow
|
|
A callback to control whether the menu should be shown or not.
|
|
|
|
Type: `(props) => boolean`
|
|
|
|
## Source code
|
|
[packages/extension-bubble-menu/](https://github.com/ueberdosis/tiptap/blob/main/packages/extension-bubble-menu/)
|
|
|
|
## Usage
|
|
|
|
### JavaScript
|
|
```js
|
|
import { Editor } from '@tiptap/core'
|
|
import BubbleMenu from '@tiptap/extension-bubble-menu'
|
|
|
|
new Editor({
|
|
extensions: [
|
|
BubbleMenu.configure({
|
|
element: document.querySelector('.menu'),
|
|
}),
|
|
],
|
|
})
|
|
```
|
|
|
|
### Frameworks
|
|
https://embed.tiptap.dev/preview/Extensions/BubbleMenu
|
|
|
|
### Custom logic
|
|
Customize the logic for showing the menu with the `shouldShow` option. For components, `shouldShow` can be passed as a prop.
|
|
|
|
```js
|
|
BubbleMenu.configure({
|
|
shouldShow: ({ editor, view, state, oldState, from, to }) => {
|
|
// only show the bubble menu for images and links
|
|
return editor.isActive('image') || editor.isActive('link')
|
|
},
|
|
})
|
|
```
|
|
|
|
### Multiple menus
|
|
Use multiple menus by setting an unique `pluginKey`.
|
|
|
|
```js
|
|
import { Editor } from '@tiptap/core'
|
|
import BubbleMenu from '@tiptap/extension-bubble-menu'
|
|
|
|
new Editor({
|
|
extensions: [
|
|
BubbleMenu.configure({
|
|
pluginKey: 'bubbleMenuOne',
|
|
element: document.querySelector('.menu-one'),
|
|
}),
|
|
BubbleMenu.configure({
|
|
pluginKey: 'bubbleMenuTwo',
|
|
element: document.querySelector('.menu-two'),
|
|
}),
|
|
],
|
|
})
|
|
```
|
|
|
|
Alternatively you can pass a ProseMirror `PluginKey`.
|
|
|
|
```js
|
|
import { Editor } from '@tiptap/core'
|
|
import BubbleMenu from '@tiptap/extension-bubble-menu'
|
|
import { PluginKey } from '@tiptap/pm/state'
|
|
|
|
new Editor({
|
|
extensions: [
|
|
BubbleMenu.configure({
|
|
pluginKey: new PluginKey('bubbleMenuOne'),
|
|
element: document.querySelector('.menu-one'),
|
|
}),
|
|
BubbleMenu.configure({
|
|
pluginKey: new PluginKey('bubbleMenuTwo'),
|
|
element: document.querySelector('.menu-two'),
|
|
}),
|
|
],
|
|
})
|
|
```
|