mirror of
https://github.com/ueberdosis/tiptap.git
synced 2024-12-23 17:07:49 +08:00
61 lines
1.7 KiB
Markdown
61 lines
1.7 KiB
Markdown
---
|
||
description: Adds a cursor when something is dragged inside the editor.
|
||
icon: drag-drop-line
|
||
---
|
||
|
||
# Dropcursor
|
||
[](https://www.npmjs.com/package/@tiptap/extension-dropcursor)
|
||
[](https://npmcharts.com/compare/@tiptap/extension-dropcursor?minimal=true)
|
||
|
||
This extension loads the [ProseMirror Dropcursor plugin](https://github.com/ProseMirror/prosemirror-dropcursor) by Marijn Haverbeke, which shows a cursor at the drop position when something is dragged into the editor.
|
||
|
||
Note that Tiptap is headless, but the dropcursor needs CSS for its appearance. There are settings for the color and width, and you’re free to add a custom CSS class.
|
||
|
||
## Installation
|
||
```bash
|
||
npm install @tiptap/extension-dropcursor
|
||
```
|
||
|
||
:::warning Are you using Yarn, pNPM, npm 6 or less?
|
||
Unfortunately your package manager does not install peer dependencies automatically and you have to install them by your own. Please [see here](https://tiptap.dev/installation/peer-dependencies#tiptapextension-dropcursor) which packages are needed and how to install them.
|
||
:::
|
||
|
||
## Settings
|
||
|
||
### color
|
||
Color of the dropcursor.
|
||
|
||
Default: `'currentColor'`
|
||
|
||
```js
|
||
Dropcursor.configure({
|
||
color: '#ff0000'
|
||
})
|
||
```
|
||
|
||
### width
|
||
Width of the dropcursor.
|
||
|
||
Default: `1`
|
||
|
||
```js
|
||
Dropcursor.configure({
|
||
width: 2,
|
||
})
|
||
```
|
||
|
||
### class
|
||
One or multiple CSS classes that should be applied to the dropcursor.
|
||
|
||
```js
|
||
Dropcursor.configure({
|
||
class: 'my-custom-class',
|
||
})
|
||
```
|
||
|
||
## Source code
|
||
[packages/extension-dropcursor/](https://github.com/ueberdosis/tiptap/blob/main/packages/extension-dropcursor/)
|
||
|
||
## Usage
|
||
https://embed.tiptap.dev/preview/Extensions/Dropcursor
|