This commit is contained in:
Philipp Kühn
2021-04-01 15:57:34 +02:00
18 changed files with 161 additions and 25 deletions

View File

@@ -2,7 +2,9 @@
[![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.
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. The menu is positioned absolute and requires a wrapper with `position: relative`, thats basically the only requirement though.
## Installation
```bash
@@ -13,15 +15,17 @@ yarn add @tiptap/extension-bubble-menu
```
## Settings
| 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. |
| Option | Type | Default | Description |
| ------------ | ------------- | ------- | -------------------------------------------------------------------- |
| element | `HTMLElement` | `null` | The DOM element that contains your menu. |
| keepInBounds | `Boolean` | `true` | When enabled, its rendered inside the bounding box of the document. |
## Source code
[packages/extension-bubble-menu/](https://github.com/ueberdosis/tiptap-next/blob/main/packages/extension-bubble-menu/)
## Using Vanilla JavaScript
## Usage
### JavaScript
```js
import { Editor } from '@tiptap/core'
import BubbleMenu from '@tiptap/extension-bubble-menu'
@@ -35,7 +39,7 @@ new Editor({
})
```
## Using a framework
### Frameworks
<demos :items="{
Vue: 'Extensions/BubbleMenu/Vue',
React: 'Extensions/BubbleMenu/React',

View File

@@ -0,0 +1,6 @@
# Bubble menu
<demos :items="{
Vue: 'Examples/BubbleMenu/Vue',
React: 'Examples/BubbleMenu/React',
}" />

View File

@@ -1,4 +1,4 @@
# Interactive node views
# Interactivity
Thanks to [node views](/guide/node-views) you can add interactivity to your nodes. If you can write it in JavaScript, you can add it to the editor.

View File

@@ -1,3 +1,3 @@
# Minimal
# Minimal setup
<demo name="Examples/Minimal" highlight="7-9,25-27" />

View File

@@ -1,3 +1,3 @@
# Savvy editor
# A clever editor
<demo name="Examples/Savvy" />

View File

@@ -1,4 +1,4 @@
# Suggestions
# Mentions
<demos :items="{
Vue: 'Examples/Community/Vue',

View File

@@ -0,0 +1,3 @@
# Tasks
<demo name="Examples/Tasks" />

View File

@@ -1,3 +0,0 @@
# Todo App
<demo name="Examples/TodoApp" />