Svelte components for tiptap v2
npm i svelte-tiptap
# or
yarn add svelte-tiptapNote
This package just provides components for svelte. For configuring/customizing the editor, refer tiptap's official documentation.
For any issues with the editor. You may need to open the issue on tiptap's repository
You can find some examples for the editor here
A Simple editor.
<script lang="ts">
import { onMount } from 'svelte';
import type { Readable } from 'svelte/store';
import { createEditor, Editor, EditorContent } from 'svelte-tiptap';
import StarterKit from '@tiptap/starter-kit';
let editor: Readable<Editor>;
onMount(() => {
editor = createEditor({
extensions: [StarterKit],
content: `Hello world!`,
});
});
</script>
<EditorContent editor={$editor} />Refer https://www.tiptap.dev/api/commands/ for available commands
Refer: https://www.tiptap.dev/api/extensions
This will make a contextual menu appear near a selection of text.
The markup and styling are totally up to you.
<script lang="ts">
import { EditorContent, FloatingMenu } from 'svelte-tiptap';
// ...create the editor instance on mount
</script>
<EditorContent editor={$editor} />
<FloatingMenu editor={$editor} />Refer: https://www.tiptap.dev/api/extensions/floating-menu
This will make a contextual menu appear near a selection of text. Use it to let users apply marks to their text selection.
The markup and styling are totally up to you.
<script lang="ts">
import { EditorContent, BubbleMenu } from 'svelte-tiptap';
// ...create the editor instance on mount
</script>
<EditorContent editor={$editor} />
<BubbleMenu editor={$editor} />Refer: https://www.tiptap.dev/api/extensions/bubble-menu
SvelteNodeViewRenderer enables rendering Svelte Components as NodeViews. The following is an example for creating a counter component
import { Node, mergeAttributes } from '@tiptap/core';
import { SvelteNodeViewRenderer } from 'svelte-tiptap';
import CounterComponent from './Counter.svelte';
export const SvelteCounterExtension = Node.create({
name: 'svelteCounterComponent',
group: 'block',
atom: true,
draggable: true, // Optional: to make the node draggable
inline: false,
addAttributes() {
return {
count: {
default: 0,
},
};
},
parseHTML() {
return [{ tag: 'svelte-counter-component' }];
},
renderHTML({ HTMLAttributes }) {
return ['svelte-counter-component', mergeAttributes(HTMLAttributes)];
},
addNodeView() {
return SvelteNodeViewRenderer(CounterComponent);
},
});<script lang="ts">
import type { NodeViewProps } from '@tiptap/core';
import cx from 'clsx';
import { NodeViewWrapper } from 'svelte-tiptap';
export let node: NodeViewProps['node'];
export let updateAttributes: NodeViewProps['updateAttributes'];
const handleClick = () => {
updateAttributes({ count: node.attrs.count + 1 });
};
</script>
<NodeViewWrapper>
<span>Svelte Component</span>
<div>
<button on:click={handleClick} type="button">
This button has been clicked {node.attrs.count} times.
</button>
</div>
</NodeViewWrapper>import { onMount, onDestroy } from 'svelte';
import type { Readable } from 'svelte/store';
import { Editor, EditorContent } from 'svelte-tiptap';
import StarterKit from '@tiptap/starter-kit';
import { SvelteCounterExtension } from './SvelteExtension';
let editor: Readable<Editor>;
onMount(() => {
editor = createEditor({
extensions: [StarterKit, SvelteCounterExtension],
content: `
<p>This is still the text editor you’re used to, but enriched with node views.</p>
<svelte-counter-component count="0"></svelte-counter-component>
<p>Did you see that? That’s a Svelte component. We are really living in the future.</p>
`,
});
});Refer https://www.tiptap.dev/guide/node-views/react/#all-available-props for the list of all available attributes. You can access them like
import type { NodeViewProps } from '@tiptap/core';
export let node: NodeViewProps['node'];
export let updateAttributes: NodeViewProps['updateAttributes'];
// ...define other props as needed.
// update attributes
const handleClick = () => {
updateAttributes({ count: node.attrs.count + 1 });
};To make your node views draggable, set draggable: true in the extension and add data-drag-handle to the DOM element that should function as the drag handle.
There is another action called editable which helps you adding editable content to your node view. Here is an example.
<script lang="ts">
import { NodeViewWrapper, NodeViewContent } from 'svelte-tiptap';
</script>
<NodeViewWrapper class="svelte-component">
<span class="label" contenteditable="false">Svelte Editable Component</span>
<!-- Content is inserted here -->
<NodeViewContent />
</NodeViewWrapper>The NodeViewWrapper and NodeViewContent components render a <div> HTML tag (<span> for inline nodes),
but you can change that. For example <NodeViewContent as="p"> should render a paragraph.
One limitation though: That tag must not change during runtime.
Refer: https://www.tiptap.dev/guide/node-views/react/#adding-a-content-editable
All types of contributions are welcome. See CONTRIBUTING.md to get started.
![dependabot[bot] avatar](https://avatars.githubusercontent.com/in/29110?v=4 "dependabot[bot]")
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent