tinymce 使用及自定义上传插件

使用框架及语言:vue3 + ts + ant design vue + vben admin

在vben admin框架中有封装使用 tinymce 且重写了上传组件,但是与项目要求的上传不一致,特记录使用中要注意的点以便下次遇到可以快速开始。
项目要求,使用tinymce 自定义上传插件使文件上传不是从本地上传,而是从已经做好的文件管理功能(已经上传到服务器中的文件)中选择上传。

项目中引入tinymce 及配置

安装

npm :
npm install @tinymce/tinymce-vue -S
npm install tinymce -S
yarn :
yarn add @tinymce/tinymce-vue
yarn add tinymce

在public目录下新建tinymce目录,将中文包和skins目录(node_modules->tinymce->skins)放到该目录

tinymce官网下载中文包
在这里插入图片描述
文件配置目录:
在这里插入图片描述

封装组件

Vben admin 框架自己有封装,我这里是把它封装的删掉之后用的根据网上找的来写得,没有封装的可以新建文件夹封装:

<template>
  <div>
    <editor v-model="myValue" :init="init" :disabled="disabled" :id="tinymceId" />
    <FileModal @register="registerModal" @success="handleSuccess" :multiple="true" />
    <!--FileModal 是封装的文件管理组件  -->
  </div>
</template>

<script setup lang="ts">
  //JS部分
  //在js中引入所需的主题和组件
  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'; //引入编辑器图标icon,不引入则不显示对应图标
  import 'tinymce/models/dom'; // 这里是个坑 一定要引入
  //在TinyMce.vue中接着引入相关插件
  import 'tinymce/icons/default/icons';
  import 'tinymce/plugins/table'; // 插入表格插件
  import 'tinymce/plugins/lists'; // 列表插件
  import 'tinymce/plugins/wordcount'; // 字数统计插件
  import 'tinymce/plugins/code'; // 源码
  import 'tinymce/plugins/codesample';
  import 'tinymce/plugins/fullscreen'; //全屏
  import 'tinymce/plugins/advlist'; //高级列表
  import 'tinymce/plugins/anchor'; //锚点
  import 'tinymce/plugins/autolink'; //自动链接
  import 'tinymce/plugins/charmap'; //特殊字符
  import 'tinymce/plugins/directionality'; //文字方向
  import 'tinymce/plugins/help'; //帮助
  import 'tinymce/plugins/importcss'; //引入css
  import 'tinymce/plugins/insertdatetime'; //插入日期时间
  import 'tinymce/plugins/nonbreaking'; //插入不间断空格
  import 'tinymce/plugins/pagebreak'; //插入分页符
  import 'tinymce/plugins/preview'; //预览
  import 'tinymce/plugins/quickbars'; //快速工具栏
  import 'tinymce/plugins/searchreplace'; //查找替换
  import 'tinymce/plugins/visualblocks'; //显示元素范围
  import 'tinymce/plugins/visualchars'; //显示不可见字符
  import 'tinymce/plugins/link'; //显示不可见字符

  //接下来定义编辑器所需要的插件数据
  import { reactive, ref } from 'vue';
  import { onMounted, defineEmits, watch } from '@vue/runtime-core';
  import axios from 'axios';
  import { getToken } from '/@/utils/auth';
  import { message } from 'ant-design-vue';
  import { getAppEnvConfig } from '/@/utils/env';
  import FileModal from '/@/attachment_web/views/FileModal/index.vue';
  import { getFileType } from '/@/utils/file/fileType';
  import { useModal } from '/@/components/Modal';
  const token = getToken();
  const { VITE_GLOB_API_URL } = getAppEnvConfig();
  // import { updateImg } from '@/api/order/order'
  const emits = defineEmits(['change']);
  // 文件选择框
  const [registerModal, { openModal, closeModal }] = useModal();
  let editors = ref<Nullable<Editor>>(null);
  //这里我选择将数据定义在props里面,方便在不同的页面也可以配置出不同的编辑器,当然也可以直接在组件中直接定义
  const props = defineProps({
    value: {
      type: String,
      default: () => {
        return '';
      },
    },
    baseUrl: {
      type: String,
      default: '',
    },
    disabled: {
      type: Boolean,
      default: false,
    },
    plugins: {
      type: [String, Array],
      default:
        'nonbreaking visualblocks visualchars pagebreak lists table code fullscreen anchor autolink charmap searchreplace preview insertdatetime help advlist directionality quickbars link codesample',
    }, //必填
    toolbar: {
      type: [String, Array],
      default: `undo redo |  bold italic underline strikethrough |formatselect fontselect fontsizeselect |alignleft aligncenter alignright alignjustify | bullist numlist outdent indent lists| Upload fullscreen | forecolor backcolor |
       searchreplace lineheight link table pagebreak code codesample 
         anchor charmap preview insertdatetime quickbars removeformat  subscript superscript selectall`,
    }, //必填
  });
  //用于接收外部传递进来的富文本
  const myValue = ref(props.value);
  const tinymceId = ref('vue-tinymce-' + +new Date() + ((Math.random() * 1000).toFixed(0) + ''));
  //定义一个对象 init初始化
  const htmlRoot = document.getElementById('htmlRoot');
  const isDark = htmlRoot?.getAttribute('data-theme') === 'dark';
  const init = reactive({
    selector: '#' + tinymceId.value, //富文本编辑器的id,
    language_url: '/tinymce/langs/zh_CN.js', // 语言包的路径,具体路径看自己的项目,文档后面附上中文js文件
    language: 'zh_CN', //语言
    skin_url: (isDark && '/tinymce/skins/ui/oxide-dark') || '/tinymce/skins/ui/oxide', // skin路径,具体路径看自己的项目
    promotion: false,
    custom_elements: 'style,html,head,body,title,meta', //允许自定义标签存在
    setup: function (editor) {
      // 注册icon 方法
      // editor.ui.registry.addIcon(
      //   'shopping-cart',
      //   `<svg viewBox="0 0 1024 1024" data-icon="shopping-cart" width="1.5em" height="1.5em" fill="currentColor" aria-hidden="true" focusable="false" class=""><path d="M922.9 701.9H327.4l29.9-60.9 496.8-.9c16.8 0 31.2-12 34.2-28.6l68.8-385.1c1.8-10.1-.9-20.5-7.5-28.4a34.99 34.99 0 0 0-26.6-12.5l-632-2.1-5.4-25.4c-3.4-16.2-18-28-34.6-28H96.5a35.3 35.3 0 1 0 0 70.6h125.9L246 312.8l58.1 281.3-74.8 122.1a34.96 34.96 0 0 0-3 36.8c6 11.9 18.1 19.4 31.5 19.4h62.8a102.43 102.43 0 0 0-20.6 61.7c0 56.6 46 102.6 102.6 102.6s102.6-46 102.6-102.6c0-22.3-7.4-44-20.6-61.7h161.1a102.43 102.43 0 0 0-20.6 61.7c0 56.6 46 102.6 102.6 102.6s102.6-46 102.6-102.6c0-22.3-7.4-44-20.6-61.7H923c19.4 0 35.3-15.8 35.3-35.3a35.42 35.42 0 0 0-35.4-35.2zM305.7 253l575.8 1.9-56.4 315.8-452.3.8L305.7 253zm96.9 612.7c-17.4 0-31.6-14.2-31.6-31.6 0-17.4 14.2-31.6 31.6-31.6s31.6 14.2 31.6 31.6a31.6 31.6 0 0 1-31.6 31.6zm325.1 0c-17.4 0-31.6-14.2-31.6-31.6 0-17.4 14.2-31.6 31.6-31.6s31.6 14.2 31.6 31.6a31.6 31.6 0 0 1-31.6 31.6z"></path></svg>`,
      // );
      // 注册一个自定义的按钮
      editor.ui.registry.addButton('Upload', {
        icon: `upload`,
        tooltip: '插入文件',
        onAction: function (_) {
          editors.value = editor;
          openModal(true);
        },
      });
    },
    height: 400, //编辑器高度
    menubar: true, //顶部菜单栏显示
    image_dimensions: false, //去除宽高属性
    plugins: props.plugins, //这里的数据是在props里面就定义好了的
    toolbar: props.toolbar, //这里的数据是在props里面就定义好了的
    toolbar_mode: 'sliding',
    fontsize_formats: '11px 12px 14px 16px 18px 20px 22px 24px 28px 32px 36px 48px 56px 72px', //字体大小
    font_formats:
      '微软雅黑=Microsoft YaHei,Helvetica Neue,PingFang SC,sans-serif;苹果苹方=PingFang SC,Microsoft YaHei,sans-serif;宋体=simsun,serif;仿宋体=FangSong,serif;黑体=SimHei,sans-serif;Arial=arial,helvetica,sans-serif;Arial Black=arial black,avant garde;Book Antiqua=book antiqua,palatino;',
    // paste_convert_word_fake_lists: false, // 插入word文档需要该属性
    paste_webkit_styles: 'all',
    paste_merge_formats: true,
    nonbreaking_force_tab: false,
    auto_focus: true,
    paste_auto_cleanup_on_paste: false,
    content_css: '/tinymce/skins/content/default/content.css', //以css文件方式自定义可编辑区域的css样式,css文件需自己创建并引入
    branding: false, //tiny技术支持信息是否显示
    paste_data_images: false, //图片是否可粘贴
  });

  // 文件选择方法
  function handleSuccess(value) {
    const { urls } = value;
    let addvalue = ``;
    for (let i = 0; i < urls.length; i++) {
      if (getFileType(urls[i]) == 'picture') {
        addvalue += `<img width='360px' src='${VITE_GLOB_API_URL || ''}/xx/${urls[i]}'/>`;
      } else if (getFileType(urls[i]) == 'video') {
        addvalue += `<video controls >
                <source src='${VITE_GLOB_API_URL || ''}/xx/${urls[i]}' type="video/mp4" />
              </video>`;
      } else if (getFileType(urls[i]) == 'audio') {
        addvalue += `<audio controls style="width: 100%" src='${VITE_GLOB_API_URL || ''}/xx/${
          urls[i]
        }'></audio>`;
      } else {
        message.warning('暂不支持该类型文件上传,请重新选择', 2);
      }
    }
    editors.value.insertContent(addvalue || '');
    closeModal();
  }

  //监听外部传递进来的的数据变化
  watch(
    () => props.value,
    () => {
      myValue.value = props.value;
      emits('change', myValue.value);
    },
  );
  //监听富文本中的数据变化
  watch(
    () => myValue.value,
    () => {
      emits('change', myValue.value);
    },
  );
  //在onMounted中初始化编辑器
  onMounted(() => {
    tinymce.init({});
  });
</script>

使用:

h(Tinymce, {
        value: model[field],
        onChange: (value: string) => {
          model[field] = value;
        },
      })
// 这是在vben admin 框架中使用的版本

或者

<Tinymce :value="value" @onChange="onChange" />

以下记录在使用tinymce 中遇到的问题

1.自定义上传插件(按钮)

在 init 中 自定义按钮,然后在toolbar 中将按钮引入,onAction中写对应需求方法即可

setup: function (editor) {
      // 注册一个自定义的按钮
      editor.ui.registry.addButton('Upload', {
        icon: `upload`,
        tooltip: '插入文件',
        onAction: function (_) {
          editors.value = editor;
          openModal(true);
        },
      });
    },
toolbar: {
      type: [String, Array],
      default: `Upload`,
    },

隐藏快速工具栏 quickbars

因为自定义了上传组件而光标处弹出的快速工具栏中的图片上传还是调用的本地上传,就要把它去掉,后面发现是引入了快速工具栏插件 quickbars ,解决办法就是不要引用它就好了!

  import 'tinymce/plugins/quickbars'; //快速工具栏 
  • 0
    点赞
  • 7
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
Tinymce 5 是一个非常流行的富文本编辑器,它具有丰富的功能和灵活的扩展性。一个自定义插件可以在 Tinymce 5 中添加一个新的功能或定制现有的功能。下面是创建一个自定义插件的步骤: 1. 创建一个 JavaScript 文件,命名为 myplugin.js。 2. 在 myplugin.js 中定义你的插件使用 tinymce.PluginManager.add() 函数将其添加到 Tinymce 5 中。例如: ``` tinymce.PluginManager.add('myplugin', function(editor, url) { // 插件的具体实现代码 }); ``` 在这里,'myplugin' 是插件的名称,editor 是 Tinymce 5 的实例,url 是插件所在的 URL。 3. 实现插件的具体功能。你可以使用 Tinymce 5 提供的 API,例如 editor.addButton()、editor.addMenuItem()、editor.addCommand() 等等。例如: ``` editor.addButton('mybutton', { text: 'My Button', icon: false, onclick: function() { alert('Hello World!'); } }); ``` 这个代码创建了一个按钮,当用户点击它时,会弹出一个对话框显示 "Hello World!"。 4. 将 myplugin.js 添加到 Tinymce 5 的配置中。在 tinymce.init() 函数中,将 myplugin.js 的 URL 添加到 plugins 属性中。例如: ``` tinymce.init({ selector: '#mytextarea', plugins: 'myplugin', toolbar: 'mybutton' }); ``` 这个代码初始化了一个 Tinymce 5 实例,使用了我们刚刚创建的插件和按钮。 5. 将 myplugin.js 文件上传到你的服务器上,并将其 URL 指定给 plugins 属性。这样,当用户打开包含 Tinymce 5 实例的页面时,它就会自动加载你的插件。 现在,你已经创建了一个自定义插件,并将它添加到了 Tinymce 5 中。当用户打开包含 Tinymce 5 实例的页面时,它就会自动加载你的插件,并显示你创建的按钮或其他功能。

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值