tiptap/docs/src/docPages/api/extensions/bubble-menu.md

43 lines
1.4 KiB
Markdown
Raw Normal View History

2021-03-30 20:07:18 +08:00
# Bubble Menu
[![Version](https://img.shields.io/npm/v/@tiptap/extension-bubble-menu.svg?label=version)](https://www.npmjs.com/package/@tiptap/extension-bubble-menu)
[![Downloads](https://img.shields.io/npm/dm/@tiptap/extension-bubble-menu.svg)](https://npmcharts.com/compare/@tiptap/extension-bubble-menu?minimal=true)
This extension will make a contextual menu appear near a selection of text.
## Installation
```bash
# with npm
npm install @tiptap/extension-bubble-menu
# with Yarn
yarn add @tiptap/extension-bubble-menu
```
## Settings
2021-03-31 20:07:23 +08:00
| Option | Type | Default | Description |
| ------------ | ------------- | --------- | --------------------------------------------------------- |
| element | `HTMLElement` | `null` | The DOM element of your menu. |
| keepInBounds | `Boolean` | `true` | Specifies that the element is not rendered across bounds. |
2021-03-30 20:07:18 +08:00
## Source code
[packages/extension-bubble-menu/](https://github.com/ueberdosis/tiptap-next/blob/main/packages/extension-bubble-menu/)
2021-03-31 20:07:23 +08:00
## Using Vanilla JavaScript
2021-03-30 20:07:18 +08:00
```js
import { Editor } from '@tiptap/core'
import BubbleMenu from '@tiptap/extension-bubble-menu'
new Editor({
extensions: [
BubbleMenu.configure({
element: document.querySelector('.menu'),
}),
],
})
```
2021-03-30 20:24:52 +08:00
## Using a framework
<demos :items="{
Vue: 'Extensions/BubbleMenu/Vue',
React: 'Extensions/BubbleMenu/React',
}" />