Merge branch 'main' of https://github.com/ueberdosis/tiptap-next into main
This commit is contained in:
@@ -9,7 +9,7 @@ This class is a central building block of tiptap. It does most of the heavy lift
|
|||||||
Check out the API documentation to see [all available options](/api/editor/).
|
Check out the API documentation to see [all available options](/api/editor/).
|
||||||
|
|
||||||
### Element
|
### Element
|
||||||
The `element` specifies the HTML element the editor will be binded too. The following code will add tiptap to an element with the `.element` class:
|
The `element` specifies the HTML element the editor will be binded too. The following code will integrate tiptap with an element with the `.element` class:
|
||||||
|
|
||||||
```js
|
```js
|
||||||
import { Editor } from '@tiptap/core'
|
import { Editor } from '@tiptap/core'
|
||||||
|
|||||||
101
docs/src/docPages/guide/getting-started/nuxtjs.md
Normal file
101
docs/src/docPages/guide/getting-started/nuxtjs.md
Normal file
@@ -0,0 +1,101 @@
|
|||||||
|
# Nuxt.js
|
||||||
|
|
||||||
|
## toc
|
||||||
|
|
||||||
|
## Introduction
|
||||||
|
The following guide describes how to integrate tiptap with your Nuxt.js project.
|
||||||
|
|
||||||
|
## Requirements
|
||||||
|
* [Node](https://nodejs.org/en/download/) installed on your machine
|
||||||
|
* Experience with [Vue](https://vuejs.org/v2/guide/#Getting-Started)
|
||||||
|
|
||||||
|
## 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 Nuxt.js project called `tiptap-example`. The following command sets up everything we need. It asks a lot of questions, but just use what floats your boat or use the defaults.
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# create a project
|
||||||
|
npm init nuxt-app tiptap-example
|
||||||
|
|
||||||
|
# change directory
|
||||||
|
cd tiptap-example
|
||||||
|
```
|
||||||
|
|
||||||
|
## 3. Install the dependencies
|
||||||
|
Okay, enough of the boring boilerplate work. Let’s finally install tiptap! For the following example you’ll need `@tiptap/core` (the actual editor) and the `@tiptap/vue-starter-kit` which has everything to get started quickly, for example a few default extensions and a basic Vue component.
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# install with npm
|
||||||
|
npm install @tiptap/core @tiptap/vue-starter-kit
|
||||||
|
|
||||||
|
# install with Yarn
|
||||||
|
yarn add @tiptap/core @tiptap/vue-starter-kit
|
||||||
|
```
|
||||||
|
|
||||||
|
If you followed step 1 and 2, you can now start your project with `npm run serve` or `yarn serve`, and open [http://localhost:8080/](http://localhost:8080/) in your favorite browser. This might be different, if you’re working with an existing project.
|
||||||
|
|
||||||
|
## 4. 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 `src/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.
|
||||||
|
|
||||||
|
```html
|
||||||
|
<template>
|
||||||
|
<editor-content :editor="editor" />
|
||||||
|
</template>
|
||||||
|
|
||||||
|
<script>
|
||||||
|
import { Editor, EditorContent, defaultExtensions } from '@tiptap/vue-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(),
|
||||||
|
})
|
||||||
|
},
|
||||||
|
|
||||||
|
beforeDestroy() {
|
||||||
|
this.editor.destroy()
|
||||||
|
},
|
||||||
|
}
|
||||||
|
</script>
|
||||||
|
```
|
||||||
|
|
||||||
|
## 5. 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.
|
||||||
|
|
||||||
|
```html
|
||||||
|
<template>
|
||||||
|
<div id="app">
|
||||||
|
<tiptap />
|
||||||
|
</div>
|
||||||
|
</template>
|
||||||
|
|
||||||
|
<script>
|
||||||
|
import Tiptap from './components/Tiptap.vue'
|
||||||
|
|
||||||
|
export default {
|
||||||
|
name: 'App',
|
||||||
|
components: {
|
||||||
|
Tiptap
|
||||||
|
}
|
||||||
|
}
|
||||||
|
</script>
|
||||||
|
```
|
||||||
|
::: warning Nuxt.js
|
||||||
|
If you use Nuxt.js, note that tiptap needs to run in the client, not on the server. It’s required to wrap the editor in a `<client-only>` tag.
|
||||||
|
:::
|
||||||
|
|
||||||
|
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.
|
||||||
@@ -3,7 +3,7 @@
|
|||||||
## toc
|
## toc
|
||||||
|
|
||||||
## Introduction
|
## Introduction
|
||||||
The following guide describes how to add tiptap to your Vue CLI project. If you’ve got Vue CLI on your machine already, you can skip the first step.
|
The following guide describes how to integrate tiptap with your Vue CLI project. If you’ve got Vue CLI on your machine already, you can skip the first step.
|
||||||
|
|
||||||
## Requirements
|
## Requirements
|
||||||
* [Node](https://nodejs.org/en/download/) installed on your machine
|
* [Node](https://nodejs.org/en/download/) installed on your machine
|
||||||
@@ -38,7 +38,7 @@ cd tiptap-example
|
|||||||
```
|
```
|
||||||
|
|
||||||
## 3. Install the dependencies
|
## 3. Install the dependencies
|
||||||
Okay, enough of the boring boilerplate work. Let’s finally install tiptap! For the following example you’ll need the `@tiptap/core` (the actual editor) and the `@tiptap/vue-starter-kit` which has everything to get started quickly, for example a few default extensions and a basic Vue component.
|
Okay, enough of the boring boilerplate work. Let’s finally install tiptap! For the following example you’ll need `@tiptap/core` (the actual editor) and the `@tiptap/vue-starter-kit` which has everything to get started quickly, for example a few default extensions and a basic Vue component.
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
# install with npm
|
# install with npm
|
||||||
@@ -48,10 +48,10 @@ npm install @tiptap/core @tiptap/vue-starter-kit
|
|||||||
yarn add @tiptap/core @tiptap/vue-starter-kit
|
yarn add @tiptap/core @tiptap/vue-starter-kit
|
||||||
```
|
```
|
||||||
|
|
||||||
If you followed step 1 and 2, you can now start your project with `npm run serve` or `yarn serve`, and open [http://localhost:8080/](http://localhost:8080/) in your favorite browser. This might be different, if you’re working with an existing project.
|
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/](http://localhost:3000/) in your favorite browser. This might be different, if you’re working with an existing project.
|
||||||
|
|
||||||
## 4. Create a new component
|
## 4. 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 `src/components/Tiptap.vue`.
|
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.
|
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.
|
||||||
|
|
||||||
@@ -89,7 +89,7 @@ export default {
|
|||||||
```
|
```
|
||||||
|
|
||||||
## 5. Add it to your app
|
## 5. 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.
|
Now, let’s replace the content of `pages/index.vue` with the following example code to use our new `Tiptap` component in our app.
|
||||||
|
|
||||||
```html
|
```html
|
||||||
<template>
|
<template>
|
||||||
@@ -97,20 +97,6 @@ Now, let’s replace the content of `src/App.vue` with the following example cod
|
|||||||
<tiptap />
|
<tiptap />
|
||||||
</div>
|
</div>
|
||||||
</template>
|
</template>
|
||||||
|
|
||||||
<script>
|
|
||||||
import Tiptap from './components/Tiptap.vue'
|
|
||||||
|
|
||||||
export default {
|
|
||||||
name: 'App',
|
|
||||||
components: {
|
|
||||||
Tiptap
|
|
||||||
}
|
|
||||||
}
|
|
||||||
</script>
|
|
||||||
```
|
```
|
||||||
::: warning Nuxt.js
|
|
||||||
If you use Nuxt.js, note that tiptap needs to run in the client, not on the server. It’s required to wrap the editor in a `<client-only>` tag.
|
|
||||||
:::
|
|
||||||
|
|
||||||
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.
|
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.
|
||||||
|
|||||||
@@ -40,6 +40,8 @@
|
|||||||
items:
|
items:
|
||||||
- title: Vue CLI
|
- title: Vue CLI
|
||||||
link: /guide/getting-started/vue-cli
|
link: /guide/getting-started/vue-cli
|
||||||
|
- title: Nuxt.js
|
||||||
|
link: /guide/getting-started/nuxtjs
|
||||||
- title: Configure the editor
|
- title: Configure the editor
|
||||||
link: /guide/configure-the-editor
|
link: /guide/configure-the-editor
|
||||||
- title: Create a toolbar
|
- title: Create a toolbar
|
||||||
|
|||||||
Reference in New Issue
Block a user