Skip to content

wertania/vue-blockful-editor

Repository files navigation

Vue-Blockful-Editor

A small block editor library for Vue3. All blocks are rendered by Block-Plugins which can be extended for custom projects.

Installation

Needs Font-Awesome

npm install vue-blockful-editor
npm install @fortawesome/fontawesome-svg-core

Blocks

Each "Block" item is a Plugin which delivers a "viewer" mode and "editor" mode. Custom Plugins can be implemented very easy.

Out of the box Vue-Blockful-Editor has these Block Plugins:

  • Paragraph
  • Delimiter
  • Embed (iFrame)
  • Header (h1,h2,h3,h4,h5,h6)
  • Paragraph (text-size: 1-5, align: center, left, right)
  • plainhtml (code)
  • RichText (based on TipTap)

Usage

<template>
  <BlockEditor v-model="demo" :readOnly="false" :debug="false" :plugins="plugins" :showAllBlockControls="true" />
</template>

<script setup>
import { BlockEditor, PluginDelimiter, PluginHeader } from 'vue-blockful-editor';

const plugins = [
  PluginDelimiter,
  PluginHeader,
];

const demo = {
  blocks: [
    {
      type: "header",
      data: {
        text: "Hello World!",
        level: 1,
      },
    },
  ],
};
</script>

Properties

modelValue: BlockPage;
readOnly: boolean;
plugins: BlockPlugin[];
debug?: boolean;
showAllBlockControls?: boolean;
uploadSettings?: UploadSettings;

Images

Images can be added in three ways: upload by clipboard, upload by File or only give a URL as Link.

Image upload

Images must be uploaded by a custom function which returns the new URL of the image as an URL.

/**
 * demo function to upload a file to a server
 */
export const uploadCustomFunction = async (file: Blob): Promise<string> => {
    const formData = new FormData();
    formData.append("file", file);
    const r = await fetch("http://localhost:3000/upload", {
        method: "POST",
        body: formData,
    });
    const response = await r.json();
    // dev server returns an object with the url of the uploaded file
    return response.url;
};

About

A block editor for vue3

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published