首页 >  vue >  vue3安装tinymce富文本编辑器

vue3安装tinymce富文本编辑器

1、如题

tinymce富文本是一款超级强大的国外开发富文本编辑器,网上关于其的教程有很多,但是都有一个缺点那就是没有区分版本,导致很多配置无法生效。

下面针对vue3的安装与使用做一个全面的介绍:

2、安装

yarn add tinymce

yarn add @tinymce/tinymce-vue

 这是我安装的最新版本:

"dependencies": {

  "@tinymce/tinymce-vue": "^5.1.1",

  "tinymce": "^6.8.1",

  },

3、安装中文包

这点基本上按照教程来即

下载中文包 地址 tinymce语言包下载这里需要注意,请下拉到最后,有个蓝色的按钮写着TinyMCE 5 All Languages,下载这个,而不是上面的Chinese Simplified那个包

在项目public文件夹下新建tinymce文件夹,将下载的汉化包解压到此文件夹

然后在node_modules/tinymce中找到skins文件夹,也复制到public/tinymce里

一共有三个文件夹

4、 直接新建1个tinymceEditor.vue组件

这里面容易搞错的是toolbar里面的内容

toolbar: {

  type: [String, Array],

  default: " fontsize fontfamily styles | bold italic | forecolor backcolor | alignleft aligncenter alignright alignjustify | bullist numlist outdent indent | image | lists link table code",

  }

由于tinymce不断更新,新版本的工具栏属性会不断变化,网上的大部分没有标明版本,可能有些属性已经修改,导致配置失效 。在文章结尾有tinymce官网,可以在需要的时候进入官网查看。

另外,关于自定义字体单位和字体大小需要注意,老版本的可能是fontsize_formats。默认字体大小单位为pt,不符合国内使用习惯

font_size_formats: "11px 12px 14px 16px 18px 24px 36px 48px 64px 72px", //文字大小
font_size_input_default_unit: "px",

在插件这里,根据自己需要引用。如果没有引用插件,工具栏里面的按钮对应引用也不会生效。具体更多插件可以查看文章结尾处的官网。

 plugins: {     type: [String, Array],     default: "lists  table link image searchreplace",   },

全部代码:

<template>
  <main>
    <editor
      v-model="myValue"
      :init="init"
      :disabled="disabled"
      :id="tinymceId"
    ></editor>
  </main>
</template>
<script setup>
import { reactive, ref, onMounted, watch } from "vue";

import tinymce from "tinymce/tinymce";
import "tinymce/skins/content/default/content.css";
import Editor from "@tinymce/tinymce-vue";
import "tinymce/themes/silver";
import "tinymce/themes/silver/theme";
import "tinymce/icons/default";
import "tinymce/models/dom";

import "tinymce/icons/default/icons";
import "tinymce/plugins/table";
import "tinymce/plugins/lists";
import "tinymce/plugins/wordcount";
import "tinymce/plugins/code";

const emits = defineEmits(["getContent"]);
const props = defineProps({
  value: {
    type: String,
    default: () => {
      return "";
    },
  },
  baseUrl: {
    type: String,
    default: "",
  },
  height: {
    type: Number,
  },
  disabled: {
    type: Boolean,
    default: false,
  },
  plugins: {
    type: [String, Array],
    default: "lists  table",
  }, //必填
  toolbar: {
    type: [String, Array],
    default:
      " fontsize fontfamily styles | bold italic | forecolor backcolor | alignleft aligncenter alignright alignjustify | bullist numlist outdent indent | image | lists link table code",
  }, //必填
});
//用于接收外部传递进来的富文本
const myValue = ref(props.value);
const tinymceId = ref(
  "vue-tinymce-" + +new Date() + ((Math.random() * 1000).toFixed(0) + "")
);
//定义一个对象 init初始化
const init = reactive({
  selector: "#" + tinymceId.value, //富文本编辑器的id,
  language_url: "/tinymce/langs/zh_CN.js", // 语言包的路径,具体路径看自己的项目,文档后面附上中文js文件
  language: "zh_CN", //语言
  skin_url: "/tinymce/skins/ui/oxide", // skin路径,具体路径看自己的项目
  height: props.height ? props.height : window.innerHeight - 150, //编辑器高度
  branding: false, //是否禁用“Powered by TinyMCE”
  menubar: true, //顶部菜单栏显示
  image_dimensions: false, //去除宽高属性
  plugins: props.plugins, //这里的数据是在props里面就定义好了的
  toolbar: props.toolbar, //这里的数据是在props里面就定义好了的
  font_formats:
    "Arial=arial,helvetica,sans-serif; 宋体=SimSun; 微软雅黑=Microsoft Yahei; Impact=impact,chicago;", //字体
  font_size_formats: "11px 12px 14px 16px 18px 24px 36px 48px 64px 72px", //文字大小
  font_size_input_default_unit: "px",
  // paste_convert_word_fake_lists: false, // 插入word文档需要该属性
  paste_webkit_styles: "all",
  paste_merge_formats: true,
  nonbreaking_force_tab: false,
  paste_auto_cleanup_on_paste: false,
  file_picker_types: "file",
  content_css: "/tinymce/skins/content/default/content.css", //以css文件方式自定义可编辑区域的css样式,css文件需自己创建并引入
  //图片上传
  images_upload_handler: (blobInfo, progress) =>
    new Promise((resolve, reject) => {
      if (blobInfo.blob().size / 1024 / 1024 > 2) {
        reject({ message: "上传失败,图片大小请控制在 2M 以内", remove: true });
        return;
      } else {
        const ph =
          import.meta.env.VITE_BASE_PATH +
          ":" +
          import.meta.env.VITE_SERVER_PORT +
          "/";
        let params = new FormData();
        params.append("file", blobInfo.blob());

        let config = {
          headers: {
            "Content-Type": "multipart/form-data",
          },
        };
        axios
          .post("xxxx", params, config)
          .then((res) => {
            if (res.data.code == 200) {
              resolve(ph + res.data.msg); //上传成功,在成功函数里填入图片路径
            } else {
              reject("HTTP Error: 上传失败" + res.data.code);
              return;
            }
          })
          .catch(() => {
            reject("上传出错,服务器开小差了呢");
            return;
          });
      }
    }),
  // 文件上传
  file_picker_callback: (callback, value, meta) => {
    // Provide file and text for the link dialog
    if (meta.filetype == "file") {
      callback("mypage.html", { text: "My text" });
    }

    // Provide image and alt text for the image dialog
    if (meta.filetype == "image") {
      callback("myimage.jpg", { alt: "My alt text" });
    }

    // Provide alternative source and posted for the media dialog
    if (meta.filetype == "media") {
      callback("movie.mp4", { source2: "alt.ogg", poster: "image.jpg" });
    }
  },
});
//监听外部传递进来的的数据变化
watch(
  () => props.value,
  () => {
    myValue.value = props.value;
    emits("getContent", myValue.value);
  }
);
//监听富文本中的数据变化
watch(
  () => myValue.value,
  () => {
    emits("getContent", myValue.value);
  }
);
//在onMounted中初始化编辑器
onMounted(() => {
  tinymce.init({});
});
</script>

5、使用

getContent可以监听内容变化,value可以绑定内容

<tinymceEditor :value="course_content" @getContent="getContent"></tinymceEditor>

 6、官网

tinymce官网

官网中有详细的工具栏按钮配置,还有很多待引用的插件,如link image等,根据自己需要引用即可

站长微信
微信公众号
站点声明:

1、本站所有内容都为原创

2、文章转载时请附带本站原文链接,谢谢。

皖ICP备2023021133号-11 Copyright © www.daimane.com All Rights Reserved