mirror of
https://github.com/ueberdosis/tiptap.git
synced 2024-12-05 04:19:07 +08:00
120 lines
3.9 KiB
Markdown
120 lines
3.9 KiB
Markdown
---
|
||
title: Svelte WYSIWYG
|
||
tableOfContents: true
|
||
---
|
||
|
||
# Svelte
|
||
|
||
## Introduction
|
||
The following guide describes how to integrate Tiptap with your [SvelteKit](https://kit.svelte.dev/) project.
|
||
|
||
## Take a shortcut: Svelte REPL with Tiptap
|
||
If you just want to jump into it right-away, here is a [Svelte REPL with Tiptap](https://svelte.dev/repl/798f1b81b9184780aca18d9a005487d2?version=3.31.2) installed.
|
||
|
||
## Requirements
|
||
* [Node](https://nodejs.org/en/download/) installed on your machine
|
||
* Experience with [Svelte](https://svelte.dev/docs#getting-started)
|
||
|
||
## 1. Create a project (optional)
|
||
If you already have an existing SvelteKit 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 SvelteKit project called `my-tiptap-project`. The following commands set up everything we need. It asks a lot of questions, but just use what floats your boat or use the defaults.
|
||
|
||
```bash
|
||
npm create svelte@latest my-tiptap-project
|
||
cd my-tiptap-project
|
||
npm install
|
||
npm run dev
|
||
```
|
||
|
||
## 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/core` package, with a few components, and `@tiptap/starter-kit` which has the most common extensions to get started quickly.
|
||
|
||
```bash
|
||
npm install @tiptap/core @tiptap/starter-kit
|
||
```
|
||
|
||
:::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 check the following links to find out what dependencies are needed and how to install them: [@tiptap/core](https://tiptap.dev/installation/peer-dependencies#tiptapcore), [@tiptap/starter-kit](https://tiptap.dev/installation/peer-dependencies#tiptapstarter-kit)
|
||
:::
|
||
|
||
If you followed step 1 and 2, you can now start your project with `npm run dev`, and open [http://localhost:3000/](http://localhost:3000/) 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 `src/lib/Tiptap.svelte`.
|
||
|
||
This is the fastest way to get Tiptap up and running with SvelteKit. 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
|
||
<script>
|
||
import { onMount, onDestroy } from 'svelte'
|
||
import { Editor } from '@tiptap/core'
|
||
import StarterKit from '@tiptap/starter-kit'
|
||
|
||
let element
|
||
let editor
|
||
|
||
onMount(() => {
|
||
editor = new Editor({
|
||
element: element,
|
||
extensions: [
|
||
StarterKit,
|
||
],
|
||
content: '<p>Hello World! 🌍️ </p>',
|
||
onTransaction: () => {
|
||
// force re-render so `editor.isActive` works as expected
|
||
editor = editor
|
||
},
|
||
})
|
||
})
|
||
|
||
onDestroy(() => {
|
||
if (editor) {
|
||
editor.destroy()
|
||
}
|
||
})
|
||
</script>
|
||
|
||
{#if editor}
|
||
<button
|
||
on:click={() => editor.chain().focus().toggleHeading({ level: 1}).run()}
|
||
class:active={editor.isActive('heading', { level: 1 })}
|
||
>
|
||
H1
|
||
</button>
|
||
<button
|
||
on:click={() => editor.chain().focus().toggleHeading({ level: 2 }).run()}
|
||
class:active={editor.isActive('heading', { level: 2 })}
|
||
>
|
||
H2
|
||
</button>
|
||
<button on:click={() => editor.chain().focus().setParagraph().run()} class:active={editor.isActive('paragraph')}>
|
||
P
|
||
</button>
|
||
{/if}
|
||
|
||
<div bind:this={element} />
|
||
|
||
<style>
|
||
button.active {
|
||
background: black;
|
||
color: white;
|
||
}
|
||
</style>
|
||
```
|
||
|
||
## 4. Add it to your app
|
||
Now, let’s replace the content of `src/routes/+page.svelte` with the following example code to use our new `Tiptap` component in our app.
|
||
|
||
```html
|
||
<script>
|
||
import Tiptap from '$lib/Tiptap.svelte'
|
||
</script>
|
||
|
||
<main>
|
||
<Tiptap />
|
||
</main>
|
||
```
|
||
|
||
You should now see Tiptap in your browser. Time to give yourself a pat on the back! :)
|