当前位置:   article > 正文

Vue2 实现内容拖拽或添加 HTML 到 Tinymce 富文本编辑器的高级功能详解_html富文本编辑器

html富文本编辑器

Web 开发中,Tinymce 被广泛应用作为富文本编辑器。除了基础的文本编辑功能,Tinymce 还提供了一系列高级功能,使得文本编辑更加灵活和便捷。本文将介绍如何在 Tinymce 中实现一些高级功能,并深入了解每个工具的使用。

Tinymce 简介

Tinymce 是一款基于 JavaScript 的富文本编辑器,支持丰富的插件和工具,可通过简单的集成和配置实现高度的定制化。它为开发者提供了一套丰富的 API,使得文本编辑变得更加轻松。其开放性和可扩展性使其成为众多开发者首选的富文本编辑解决方案之一。

效果展示

实现功能详解

1. 实现点击外部按钮,将内容添加到富文本内

通过 Vue2 和 Tinymce 6x 版本,我们可以通过精心配置和处理事件,实现点击外部按钮时,将指定内容添加到富文本编辑器内。这一功能旨在为用户提供更直观和高效的文本编辑体验。

代码示例:

  1. // 在 Vue 组件中处理按钮点击事件,将内容插入富文本编辑器
  2. appendContentInTinymce() {
  3. let html = `<span style="color:red;">我是点击后到富文本的内容。</span>`;
  4. this.editor.insertContent(html);
  5. }

2. 实现拖动外部按钮,将内容添加到富文本内

借助拖拽功能,用户可以将指定内容从外部按钮拖动到富文本编辑器中。这种直观的操作方式提高了用户的操作效率。

代码示例:

  1. // 在 Vue 组件中处理拖拽事件,将拖动的内容插入富文本编辑器
  2. onDragStart(event) {
  3. let html = `
  4. <table style="border-collapse: collapse;width: 80%;margin-left: 20%;" border="1">
  5. <tbody>
  6. <tr>
  7. <td colspan="3" style="width: 100%;">
  8. <div style="color:blue;text-align:center;">我是被拖进来的</div>
  9. </td>
  10. </tr>
  11. <tr>
  12. <td style="width: 33.3333%;"></td>
  13. <td style="width: 33.3333%;"></td>
  14. <td style="width: 33.3333%;"></td>
  15. </tr>
  16. <tr>
  17. <td style="width: 33.3333%;"></td>
  18. <td style="width: 33.3333%;"></td>
  19. <td style="width: 33.3333%;"></td>
  20. </tr>
  21. </tbody>
  22. </table>
  23. `;
  24. event.dataTransfer.setData("text/html", html);
  25. }

3. 实现拖动外部按钮,将一个整体添加到富文本内

通过对整块内容的拖拽,我们不仅可以实现单个元素的拖动,还可以将一整块内容作为一个整体拖动到富文本中。这为用户提供了更灵活的编辑方式。

代码示例:

  1. // 在 Vue 组件中处理拖拽事件,将整体内容插入富文本编辑器
  2. onDragStartMceNonEditable(event) {
  3. let html = `<span style="color:green;" class="mceNonEditable">我是被拖进来的,我是一块整体。</span>`;
  4. event.dataTransfer.setData("text/html", html);
  5. }

版本介绍

使用vue2 版本和tinymce 6x 版本

  1. "@tinymce/tinymce-vue": "^3",
  2. "core-js": "^3.8.3",
  3. "tinymce": "^6.8.2",
  4. "vue": "^2.6.14"

tinymce 6x 和 tinymce 5x版本代码写法不同

具体代码展示

  1. <template>
  2. <div>
  3. <div class="buttons">
  4. <button @click="toggleEditorReadOnly">编辑器开关</button>
  5. <button class="my-custom-button">点击我不会触发blur事件</button>
  6. <button @click="appendContentInTinymce">你可以点击我到富文本</button>
  7. <button draggable="true" @dragstart="(event) => onDragStart(event)">
  8. 你可以拖动我到富文本
  9. </button>
  10. <button
  11. draggable="true"
  12. @dragstart="(event) => onDragStartMceNonEditable(event)"
  13. >
  14. 你可以拖动我到富文本,我的内容是一块整体
  15. </button>
  16. </div>
  17. <textarea ref="tinymce" :id="textareaId"></textarea>
  18. </div>
  19. </template>
  20. <script>
  21. import tinymce from "tinymce/tinymce";
  22. import "tinymce/themes/silver";
  23. export default {
  24. props: {
  25. value: String,
  26. options: Object,
  27. },
  28. data() {
  29. return {
  30. textareaId: `tinymce-${Math.random().toString(36).substring(7)}`,
  31. editor: null,
  32. };
  33. },
  34. mounted() {
  35. this.initializeEditor();
  36. },
  37. watch: {
  38. value(newValue) {
  39. if (newValue !== this.editor.getContent()) {
  40. this.editor.setContent(newValue);
  41. }
  42. },
  43. },
  44. methods: {
  45. initializeEditor() {
  46. const defaultOptions = {
  47. /**
  48. * 插件
  49. * autoresize 可以根据内容自动调整编辑器的高度
  50. * code 显示TinyMCE编辑区的原始html
  51. * lists,advlist 高级列表插件,扩展了默认的UL (bullist) 和OL (numlist)列表样式.另外该插件也提供了自定义的选项advlist_bullet_styles, advlist_number_styles
  52. * codesample 代码示例插件,扩展codesample_languages
  53. * directionality 将文本放到左边或右边ltr rtl
  54. * image 图像插件
  55. * editimage 编辑图像插件 要收费
  56. * emoticons 表情库
  57. * export 导出pdf插件 要收费
  58. * formatpainter 格式刷 要收费
  59. * fullscreen 全屏插件
  60. * help 帮助
  61. * insertdatetime 插入日期
  62. * link 链接
  63. * media 该插件为用户提供了将 HTML5 视频和音频元素添加到可编辑区域的能力
  64. * nonbreaking 插入不间断空格实体
  65. * pagebreak 使用户能够在可编辑区域插入分页符
  66. * preview 预览
  67. * save 保存
  68. * searchreplace 搜索和替换插件
  69. * template 模板插件.即将到来的 TinyMCE 7.0 版本中完全删除。作为替代解决方案,我们建议使用 Advanced Template Premium 插件
  70. * visualblocks 该插件允许用户在可编辑区域中查看块级元素
  71. * wordcount 字数统计
  72. */
  73. plugins:
  74. "autoresize code codesample lists advlist accordion table fullscreen anchor directionality emoticons help image insertdatetime media nonbreaking pagebreak preview save searchreplace visualblocks wordcount",
  75. autoresize_overflow_padding: 0,
  76. /**
  77. * 工具栏
  78. * undo 撤销
  79. * redo 重做
  80. * bold 加粗
  81. * italic 斜体
  82. * alignleft aligncenter alignright alignjustify 文本对齐
  83. * outdent 减小当前段落或列表项的缩进级别
  84. * indent 增加当前段落或列表项的缩进级别
  85. * lineheight 行高的下拉列表
  86. * code 显示TinyMCE的html
  87. * bullist 创建或移除无序列表
  88. * numlist 创建或移除有序列表
  89. * backcolor 将背景色应用于选区
  90. * blocks 标题列表
  91. * copy 复制到剪切板
  92. * copy 将当前所选内容剪切到剪贴板中
  93. * fontfamily 字体系列的下拉列表
  94. * fontsize 字体大小的下拉列表
  95. * fontsizeinput 输入字段提供增大和减小字体大小按钮
  96. * forecolor 修改文本颜色
  97. * h1-h6 文本标题
  98. * hr 插入水平线
  99. * newdocument 创建一个新文档
  100. * pastetext 打开/关闭纯文本粘贴模式
  101. * print 打印当前编辑器内容
  102. * remove 移除(删除)所选内容或光标位置之前的内容
  103. * removeformat 从当前选定内容中删除格式
  104. * selectall 选择编辑器中的所有内容
  105. * strikethrough 将删除线格式应用于当前选区
  106. * styles 所选内容的样式的下拉列表
  107. * subscript 将下标格式应用于当前选定内容
  108. * superscript 将上标格式应用于当前选定内容
  109. * underline 将下划线格式应用于当前选定内容
  110. * undo 撤消上一个操作
  111. * visualaid 切换不可见元素的视觉辅助工具
  112. */
  113. toolbar:
  114. "undo redo | bold italic | alignleft aligncenter alignright alignjustify | outdent indent lineheight accordion| bullist numlist backcolor forecolor blocks fontfamily styles fontsize fontsizeinput h1 h2 h3 h4 h5 h6 | copy cut newdocument pastetext print remove selectall code codesample | hr strikethrough subscript superscript underline removeformat visualaid | table tableinsertdialog tablecellprops tableprops fullscreen anchor ltr rtl emoticons help image media insertdatetime link nonbreaking pagebreak preview save searchreplace visualblocks wordcount",
  115. autoresize_bottom_margin: 16, // 自动调整高度的底部边距
  116. height: 500, // 编辑器高度
  117. min_height: 500, // 最小编辑器高度
  118. placeholder: "请输入...", // 占位符
  119. // advlist_bullet_styles: "square", // 无序列表是否使用方形
  120. advlist_number_styles:
  121. "lower-alpha,lower-roman,upper-alpha,upper-roman", // 小写字母,小写罗马数字,大写字母,大写罗马数字
  122. auto_focus: true, // 让编辑器加载完成后自动获得光标焦点
  123. cache_suffix: Math.random().toString(36).substring(7), // 可在TinyMCE加载js和css文件时,在URL请求后面自动加上指定的后缀,多用于解决缓存问题。
  124. // content_security_policy: "default-src 'self'",//内容安全策略.仅允许当前域名,不包括子域名
  125. // external_plugins: {
  126. // // 引入站外插件.可用于引入本站外部提供的插件,TinyMCE将根据插件加载规则加载指定URL的插件。当从CDN加载TinyMCE或希望TinyMCE主目录与自定义插件分开时,可使用此配置。
  127. // testing: "http://www.testing.com/plugin.min.js",
  128. // maths: "http://www.maths.com/plugin.min.js",
  129. // },
  130. readonly: false, // 是否只读模式
  131. // suffix: '.min', // 后缀。如果主程序叫tinymce.js,它在加载插件时就会去找插件文件夹里的plugin.js;如果主程序叫tinymce.min.js,它在加载插件时就会去找plugin.min.js。
  132. // target: el, // 使用Node替代selector
  133. custom_ui_selector: ".my-custom-button", // 可指定某些元素成为编辑器的一部分,当焦点移动到此选择器匹配的元素上时,不会触发编辑器的blur事件
  134. highlight_on_focus: true, // 获得输入焦点时,编辑器添加蓝色轮廓
  135. toolbar_mode: "wrap", // 不会被折叠隐藏
  136. codesample_languages: [
  137. { text: "HTML/XML", value: "markup" },
  138. { text: "JavaScript", value: "javascript" },
  139. { text: "CSS", value: "css" },
  140. { text: "PHP", value: "php" },
  141. { text: "Ruby", value: "ruby" },
  142. { text: "Python", value: "python" },
  143. { text: "Java", value: "java" },
  144. { text: "C", value: "c" },
  145. { text: "C#", value: "csharp" },
  146. { text: "C++", value: "cpp" },
  147. ],
  148. extended_valid_elements:
  149. "script[src],span[class|style|title],table[class|style]", // 给元素添加有效属性
  150. save_onsavecallback: () => {
  151. console.log("Saved");
  152. },
  153. // 初始化前执行
  154. setup: (editor) => {
  155. this.editor = editor;
  156. editor.on("change", () => {
  157. this.$emit("input", editor.getContent());
  158. });
  159. editor.on("blur", () => {
  160. console.log("触发了 blur");
  161. });
  162. editor.on("dragover", function (event) {
  163. console.log("dragover");
  164. event.preventDefault();
  165. });
  166. editor.on("drop", function (event) {
  167. console.log("drop");
  168. event.preventDefault();
  169. var htmlContent = event.dataTransfer.getData("text/html");
  170. editor.insertContent(htmlContent);
  171. });
  172. },
  173. // 初始化结束后执行
  174. init_instance_callback: function (editor) {
  175. console.log("ID为: " + editor.id + " 的编辑器已初始化完成.");
  176. },
  177. };
  178. tinymce.init({
  179. ...defaultOptions,
  180. ...this.options,
  181. selector: `#${this.textareaId}`,
  182. });
  183. },
  184. toggleEditorReadOnly() {
  185. const editor = tinymce.get(this.textareaId); // 替换为你的编辑器 ID
  186. const status = editor.mode.get();
  187. if (status === "design") {
  188. editor.mode.set("readonly"); // 设为设计模式,允许编辑
  189. } else {
  190. editor.mode.set("design"); // 设为只读模式
  191. }
  192. },
  193. appendContentInTinymce() {
  194. let html = `<span style="color:red;">我是点击后到富文本的。</span>`;
  195. this.editor.insertContent(html);
  196. },
  197. onDragStart(event) {
  198. let html = `
  199. <table style="border-collapse: collapse;width: 80%;margin-left: 20%;" border="1">
  200. <tbody>
  201. <tr>
  202. <td colspan="3" style="width: 100%;">
  203. <div style="color:blue;text-align:center;">我是被拖进来的</div>
  204. </td>
  205. </tr>
  206. <tr>
  207. <td style="width: 33.3333%;"></td>
  208. <td style="width: 33.3333%;"></td>
  209. <td style="width: 33.3333%;"></td>
  210. </tr>
  211. <tr>
  212. <td style="width: 33.3333%;"></td>
  213. <td style="width: 33.3333%;"></td>
  214. <td style="width: 33.3333%;"></td>
  215. </tr>
  216. </tbody>
  217. </table>
  218. `;
  219. event.dataTransfer.setData("text/html", html);
  220. },
  221. onDragStartMceNonEditable(event) {
  222. let html = `<span style="color:green;" class="mceNonEditable">我是被拖进来的,我是一块整体。</span>`;
  223. event.dataTransfer.setData("text/html", html);
  224. },
  225. },
  226. beforeDestroy() {
  227. if (this.editor) {
  228. this.editor.destroy();
  229. }
  230. },
  231. };
  232. </script>
  233. <style scoped>
  234. .buttons {
  235. padding-bottom: 30px;
  236. }
  237. button {
  238. margin-left: 15px;
  239. cursor: pointer;
  240. }
  241. </style>

总结

Tinymce 提供了丰富的插件和工具,使得富文本编辑更加灵活。通过探索这些高级功能,我们可以根据项目需求实现定制化的文本编辑器,提升用户体验。

通过本文的介绍,相信你对 Tinymce 的高级功能有了更深入的了解。在实际项目中,结合具体需求,灵活运用这些功能,将为你的文本编辑带来更多可能性。

 

声明:本文内容由网友自发贡献,不代表【wpsshop博客】立场,版权归原作者所有,本站不承担相应法律责任。如您发现有侵权的内容,请联系我们。转载请注明出处:https://www.wpsshop.cn/w/凡人多烦事01/article/detail/733876
推荐阅读
相关标签
  

闽ICP备14008679号