element-tiptap

A WYSIWYG editor based on tiptap and uses Element's components.

Demo

Live Demo

Features

• use Element's components
• markdown support
• renderless
• events you might use: init, transaction, focus, blur, paste, drop, update
• add your own extensions
• customize all extension menu button view
• menu buttons can render in menubar and bubble menu
• all it's up to you.

Installation

yarn add element-tiptap
# Or
npm install --save element-tiptap

Usage

Install element-tiptap plugin.

import Vue from 'vue';
import { ElementTiptapPlugin } from 'element-tiptap';

Vue.use(ElementTiptapPlugin);

Now you globally register 'element-tiptap' component.

Import extensions in component

<template>
  <div>
    <el-tiptap
      v-model="content"
      :extensions="extensions"
    />
  </div>
</template>

<script>
import {
  // necessary extensions
  Doc,
  Text,
  Paragraph,
  Heading,
  Bold,
  Underline,
  Italic,
  Strike,
  ListItem,
  BulletList,
  OrderedList,
} from 'element-tiptap';

export default {
  data () {
    // editor extensions
    // they will be added to menubar and bubble menu by the order you declare.
    extensions: [
      new Doc(),
      new Text(),
      new Paragraph(),
      new Heading({ level: 5 }),
      new Bold({ bubble: true }), // render command-button in bubble menu.
      new Underline(),
      new Italic(),
      new Strike(),
      new ListItem(),
      new BulletList(),
      new OrderedList(),
    ],
    // editor's content
    content: `
      <h1>Heading</h1>
      <p>This Editor is awesome!</p>
    `,
  },
},
</script>

Props

extensions

You can use the necessary extensions. The corresponding command-buttons will be added by declaring the order of the extension.

All available extensions:

• Doc
• Text
• Paragraph
• Heading
• Bold
• Italic
• Strike
• Underline
• Link
• Image
• CodeBlock
• Blockquote
• ListItem
• BulletList
• OrderedList
• TodoItem
• TodoList
• TextAlign
• Indent
• LineHeight
• HorizontalRule
• HardBreak
• TrailingNode
• History

You can customize the extension menu button view,

1. create your custom extension.

// create your extension file
import { Bold } from 'element-tiptap';

export default class CustomBold extends Bold {
  menuBtnView (editorContext) {
    // editorContext contains a collection of properties that are useful to you
    // see https://github.com/scrumpy/tiptap#editormenubar
    // ElTiptap plus editor instance to editorContext.
    return {
      component: CustomButton, // your component
      componentProps: {
        ...
      },
    },
  }
}

1. use custom extension in component

<template>
  <el-tiptap :extensions="extensions />
</template>

<script>
import CustomBold from '...'; // import your extension

export default {
  ...
  data () {
    return {
      extensions: [
        ...
        new CustomBold(),
      ],
    };
  },
};
</script>

placeholder

When editor is empty, placeholder will display.

<el-tiptap
  placeholder="Write something …"
/>

content

Editor's content

<el-tiptap
  :content="content"
  @onUpdate="onEditorUpdate"
/>

or Use 'v-model'

<el-tiptap
  v-model="content"
/>

output

Output can be defined to 'html'(default) or 'json'.

<el-tiptap
  output="json"
/>

Events

Init

<template>
  <el-tiptap
    @init="onInit"
  />
</template>

<script>
export default {
  ...
  methods: {
    // argument (object)
    // {
    //   editor: Editor, // tiptap editor instance
    // }
    methods: {
      onInit ({ editor }) {

      },
    },
  },
},
</script>

Transaction, Focus, Blur, Paste, Drop

The same as init

Slots

menubar

You can customize the menubar.

<el-tiptap
  v-model="content"
  :extensions="extensions"
>
  <template #menubar="{ commands, isActive }">
    <!--You can render custom menu buttons.-->
    <custom-button
      :class="{ 'is-active': isActive.bold() }"
      @click="commands.bold"
    >
      Bold
    </custom-button>
  </template>
</el-tiptap>

menububble

Customize the bubble menu like menubar.

<el-tiptap
  v-model="content"
  :extensions="extensions"
>
  <template #menububble="{ commands, isActive }">
    <custom-button
      :class="{ 'is-active': isActive.bold() }"
      @click="commands.bold"
    >
      Bold
    </custom-button>
  </template>
</el-tiptap>

footer

Footer of the editor, after the editor content.

Changelog

Changelog

Roadmap

• Table
• Text Color
• Text Background Color
• Font Size
• Font Type

Licence

MIT

Changelog

1.2.0 (2019-12-28)

Bug Fixes

• 🐛 ensure heading extension attr level is number type (a1d51aa)
• 💄 editor content text-align, default to left (0631364)
• 🔧 remove unnecessary peerDependencies (f183a7b)

Features

• ✨ support hard_break extension (d3daa6a)