From 810f3d6b6dc33f288ce77d86e870a62e0e8f4ce5 Mon Sep 17 00:00:00 2001
From: Hans Pagel <hans.pagel@ueber.io>
Date: Thu, 5 Nov 2020 21:39:08 +0100
Subject: [PATCH] add content to the dropcursor page

---
 .../demos/Extensions/Dropcursor/index.spec.js |  5 ++
 .../src/demos/Extensions/Dropcursor/index.vue | 46 +++++++++++++++++++
 docs/src/demos/Extensions/Gapcursor/index.vue | 32 -------------
 .../src/docPages/api/extensions/dropcursor.md | 12 ++---
 docs/src/links.yaml                           |  1 -
 5 files changed, 54 insertions(+), 42 deletions(-)
 create mode 100644 docs/src/demos/Extensions/Dropcursor/index.spec.js
 create mode 100644 docs/src/demos/Extensions/Dropcursor/index.vue

diff --git a/docs/src/demos/Extensions/Dropcursor/index.spec.js b/docs/src/demos/Extensions/Dropcursor/index.spec.js
new file mode 100644
index 000000000..4b9ff4eed
--- /dev/null
+++ b/docs/src/demos/Extensions/Dropcursor/index.spec.js
@@ -0,0 +1,5 @@
+context('/examples/dropcursor', () => {
+  before(() => {
+    cy.visit('/examples/dropcursor')
+  })
+})
diff --git a/docs/src/demos/Extensions/Dropcursor/index.vue b/docs/src/demos/Extensions/Dropcursor/index.vue
new file mode 100644
index 000000000..613f754d6
--- /dev/null
+++ b/docs/src/demos/Extensions/Dropcursor/index.vue
@@ -0,0 +1,46 @@
+<template>
+  <div>
+    <editor-content :editor="editor" />
+  </div>
+</template>
+
+<script>
+import { Editor, EditorContent } from '@tiptap/vue-starter-kit'
+import Document from '@tiptap/extension-document'
+import Paragraph from '@tiptap/extension-paragraph'
+import Text from '@tiptap/extension-text'
+import Dropcursor from '@tiptap/extension-dropcursor'
+import Image from '@tiptap/extension-image'
+
+export default {
+  components: {
+    EditorContent,
+  },
+
+  data() {
+    return {
+      editor: null,
+    }
+  },
+
+  mounted() {
+    this.editor = new Editor({
+      extensions: [
+        Document(),
+        Paragraph(),
+        Text(),
+        Image(),
+        Dropcursor(),
+      ],
+      content: `
+        <p>Try to drag around the image. While you drag, the editor should show a decoration under your cursor. The so called dropcursor.</p>
+        <img src="https://source.unsplash.com/8xznAGy4HcY/800x400" />
+      `,
+    })
+  },
+
+  beforeDestroy() {
+    this.editor.destroy()
+  },
+}
+</script>
diff --git a/docs/src/demos/Extensions/Gapcursor/index.vue b/docs/src/demos/Extensions/Gapcursor/index.vue
index 11d5bc99d..ce5a475da 100644
--- a/docs/src/demos/Extensions/Gapcursor/index.vue
+++ b/docs/src/demos/Extensions/Gapcursor/index.vue
@@ -44,35 +44,3 @@ export default {
   },
 }
 </script>
-
-<style lang="scss">
-/* Copied from the original prosemirror-gapcursor plugin by Marijn Haverbeke */
-/* https://github.com/ProseMirror/prosemirror-gapcursor/blob/master/style/gapcursor.css */
-
-.ProseMirror-gapcursor {
-  display: none;
-  pointer-events: none;
-  position: absolute;
-  border: 10px solid red;
-}
-
-.ProseMirror-gapcursor:after {
-  content: "";
-  display: block;
-  position: absolute;
-  top: -2px;
-  width: 20px;
-  border-top: 1px solid black;
-  animation: ProseMirror-cursor-blink 1.1s steps(2, start) infinite;
-}
-
-@keyframes ProseMirror-cursor-blink {
-  to {
-    visibility: hidden;
-  }
-}
-
-.ProseMirror-focused .ProseMirror-gapcursor {
-  display: block;
-}
-</style>
diff --git a/docs/src/docPages/api/extensions/dropcursor.md b/docs/src/docPages/api/extensions/dropcursor.md
index 8759a51c8..7ed60c6d9 100644
--- a/docs/src/docPages/api/extensions/dropcursor.md
+++ b/docs/src/docPages/api/extensions/dropcursor.md
@@ -1,4 +1,7 @@
 # Dropcursor
+This extension loads the [ProseMirror Gapcursor plugin](https://github.com/ProseMirror/prosemirror-gapcursor) by Marijn Haverbeke, which adds a gap for the cursor in places that don’t allow regular selection. For example, after a table at the end of a document.
+
+Note that tiptap is renderless, but the dropcursor needs CSS for its appearance. The default CSS is added to the usage example below.
 
 ## Installation
 ```bash
@@ -9,15 +12,6 @@ npm install @tiptap/extension-dropcursor
 yarn add @tiptap/extension-dropcursor
 ```
 
-## Settings
-*None*
-
-## Commands
-*None*
-
-## Keyboard shortcuts
-*None*
-
 ## Source code
 [packages/extension-dropcursor/](https://github.com/ueberdosis/tiptap-next/blob/main/packages/extension-dropcursor/)
 
diff --git a/docs/src/links.yaml b/docs/src/links.yaml
index 00bdd4566..5f63280ad 100644
--- a/docs/src/links.yaml
+++ b/docs/src/links.yaml
@@ -167,7 +167,6 @@
           premium: true
         - title: Dropcursor
           link: /api/extensions/dropcursor
-          draft: true
         - title: Focus
           link: /api/extensions/focus
           draft: true