mirror of https://github.com/ueberdosis/tiptap.git synced 2024-12-03 02:39:02 +08:00

* docs: update installation guides

* docs: remove base setup

* docs: complete the prosemirror package documentation

2023-02-07 10:18:53 +01:00

3.5 KiB

Raw Blame History

title	tableOfContents
Svelte WYSIWYG	true

Svelte

Introduction

The following guide describes how to integrate Tiptap with your SvelteKit 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 installed.

Requirements

Node installed on your machine
Experience with Svelte

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.

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, @tiptap/pm and @tiptap/starter-kit, which includes the most common extensions to get started quickly.

npm install @tiptap/core @tiptap/pm @tiptap/starter-kit

If you followed step 1 and 2, you can now start your project with npm run dev, and open 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.

<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.

<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! :)

3.5 KiB Raw Blame History Unescape Escape