1.0.0 • Published 1 year ago

vue-tailwind-wysiwyg-editor v1.0.0

Weekly downloads
-
License
MIT
Repository
github
Last release
1 year ago

Captura de tela de 2024-05-07 13-31-32

📺 Demo

https://vue-tailwind-editor-demo.vercel.app/

Requirements

  1. TailwindCSS
  2. TailwindCSS Typography Plugin

You need to have those dependencies installed in your project in order to everything works great ;)

🚀 Installation

  1. Install using your package manager of choice:
npm i vue-tailwind-wysiwyg-editor
  1. Add the source files of Vue Tailwind WYSIWYG Editor to the tailwind.config.js template path:
module.exports = {
  content: [
    // other files...
    './node_modules/vue-tailwind-wysiwyg-editor/**/*.{js,ts,vue}',
  ],
}

⚙️ Usage

Import the component locally or define it globally:

<template>
  <div class="flex flex-col items-center justify-center w-full h-screen gap-4">
    <VueTailwindEditor @get-html="updateHtml" />
  </div>
</template>


<script setup lang="ts">
import { ref } from 'vue'
import { VueTailwindEditor } from 'vue-tailwind-wysiwyg-editor';
import 'vue-tailwind-wysiwyg-editor/dist/style.css' // need to import the style file
const html = ref<string>("")

const updateHtml = (val: string) => {
  html.value = val;
};
</script>

📃 Props

PropTypeDefault ValueRequiredDescription
heightString'400'NoSets the height of the editor in pixels.
widthString'700'NoSets the width of the editor in pixels.
editorBackgroundStringNoneNoSets the background color of the editor.
placeholderStringWrite something...NoSets the placeholder text displayed when the editor is empty.
keysObjectdefaultTranslationsNoAn object to customize the titles of the toolbar buttons.

The defaultTranslations object provides default English-language titles for each of the toolbar buttons. The keys object allows you to easily customize the button labels to match your application's language or user preferences.

You can override any of these values by passing your own keys prop to the VueTailwindEditor component. For example, if you want to change the label for the 'bold' button to 'Negrito' in Portuguese, you would pass a keys object like this:

<VueTailwindEditor :keys="{ bold: 'Negrito' }" />

✨ Events

EventPayload TypeDescription
@get-htmlStringEmitted whenever the content of the editor changes. It provides the updated HTML content of the editor as a payload to the event listener.

The @get-html event is a key feature of the VueTailwindEditor component. This event is triggered every time there is a change in the content of the editor. When this event occurs, the updated HTML content of the editor is passed as a payload to the event listener function.

1.0.0

1 year ago