Vue.js 3

Introduction

The following guide describes how to integrate tiptap with your Vue CLI project.

Requirements

Node installed on your machine
Vue CLI installed on your machine
Experience with Vue

1. Create a project (optional)

If you already have an existing Vue project, that’s fine too. Just skip this step and proceed with the next step.

For the sake of this guide, let’s start with a fresh Vue project called tiptap-example. The Vue CLI sets up everything we need, just select the default Vue 2 template.

# create a project
vue create tiptap-example

# change directory
cd tiptap-example

2. Install the dependencies

Okay, enough of the boring boilerplate work. Let’s finally install tiptap! For the following example you’ll need the @tiptap/vue-3 package, with a few components, and @tiptap/starter-kit which has the most common extensions to get started quickly.

# install with npm
npm install @tiptap/vue-3 @tiptap/starter-kit

# install with Yarn
yarn add @tiptap/vue-3 @tiptap/starter-kit

If you followed step 1 and 2, you can now start your project with npm run dev or yarn dev, and open http://localhost:8080/ in your favorite browser. This might be different, if you’re working with an existing project.

3. Create a new component

To actually start using tiptap, you’ll need to add a new component to your app. Let’s call it Tiptap and put the following example code in components/Tiptap.vue.

This is the fastest way to get tiptap up and running with Vue. It will give you a very basic version of tiptap, without any buttons. No worries, you will be able to add more functionality soon.

<template>
  <editor-content :editor="editor" />
</template>

<script>
import { Editor, EditorContent } from '@tiptap/vue-3'
import { defaultExtensions } from '@tiptap/starter-kit'

export default {
  components: {
    EditorContent,
  },

  data() {
    return {
      editor: null,
    }
  },

  mounted() {
    this.editor = new Editor({
      content: '<p>I’m running tiptap with Vue.js. 🎉</p>',
      extensions: defaultExtensions(),
    })
  },

  beforeUnmount() {
    this.editor.destroy()
  },
}
</script>

Alternatively, you can use the Composition API with the useEditor method.

<template>
  <editor-content :editor="editor" />
</template>

<script>
import { useEditor, EditorContent } from '@tiptap/vue-3'
import { defaultExtensions } from '@tiptap/starter-kit'

export default {
  components: {
    EditorContent,
  },

  setup() {
    const editor = useEditor({
      content: '<p>I’m running tiptap with Vue.js. 🎉</p>',
      extensions: defaultExtensions(),
    })

    return { editor }
  },
}
</script>

4. Add it to your app

Now, let’s replace the content of src/App.vue with the following example code to use our new Tiptap component in our app.

<template>
  <div id="app">
    <tiptap />
  </div>
</template>

<script>
import Tiptap from './components/Tiptap.vue'

export default {
  name: 'App',
  components: {
    Tiptap
  }
}
</script>

You should now see tiptap in your browser. You’ve successfully set up tiptap! Time to give yourself a pat on the back. Let’s start to configure your editor in the next step.

5. Use v-model (optional)

You’re probably used to bind your data with v-model in forms, that’s also possible with tiptap. Here is how that would work with tiptap:

<template>
  <editor-content :editor="editor" />
</template>

<script>
import { Editor, EditorContent } from '@tiptap/vue-3'
import { defaultExtensions } from '@tiptap/starter-kit'

export default {
  components: {
    EditorContent,
  },

  props: {
    modelValue: {
      type: String,
      default: '',
    },
  },

  data() {
    return {
      editor: null,
    }
  },

  watch: {
    modelValue(value) {
      const isSame = this.editor.getHTML() === value

      if (isSame) {
        return
      }

      this.editor.commands.setContent(this.modelValue, false)
    },
  },

  mounted() {
    this.editor = new Editor({
      content: this.modelValue,
      extensions: defaultExtensions(),
    })

    this.editor.on('update', () => {
      this.$emit('update:modelValue', this.editor.getHTML())
    })
  },

  beforeUnmount() {
    this.editor.destroy()
  },
}
</script>

4.4 KiB Raw Blame History Unescape Escape