vue中使用vue-quill-editor富文本编辑器，自定义toolbar修改工具栏options

基于webpack和vue

一、npm 安装 vue-quill-editor
二、在main.js中引入

import  VueQuillEditor from 'vue-quill-editor'
// require styles 引入样式
import 'quill/dist/quill.core.css'
import 'quill/dist/quill.snow.css'
import 'quill/dist/quill.bubble.css'

Vue.use(VueQuillEditor)

三、在模块中引用

<template>
     <quill-editor 
      v-model="content" 
      ref="myQuillEditor" 
      :options="editorOption" 
      @blur="onEditorBlur($event)" @focus="onEditorFocus($event)"
      @change="onEditorChange($event)">
    </quill-editor>
</template> 
<script>
    import { quillEditor } from 'vue-quill-editor'
    export default{
        data(){
            return {
                content:null,
                editorOption:{}
            }
        },
        methods:{
            onEditorBlur(){//失去焦点事件
            },
            onEditorFocus(){//获得焦点事件
            },
            onEditorChange(){//内容改变事件
            }
        }
    }
</script>

这样引入后你会得到这样一个编辑器 vue-quill-editor
那么你如果不需要那么多的工具栏功能要怎么办呢；应该是通过options来修改但是他的默认值是什么的
我在百度找了一圈也没找到方法
最后在https://quilljs.com/docs/themes/这个官方文档里面看到了类似的方法
这里写图片描述
初始值的设置应该是一样的吧
所以我就照着toolbar部分去修改了options

<script>
    import { quillEditor } from 'vue-quill-editor'
    export default{
        data(){
            return {
                content:null,
                editorOption:{
                    modules:{
                        toolbar:[
                          ['bold', 'italic', 'underline', 'strike'],        // toggled buttons
                           ['blockquote', 'code-block']
                        ]
                    }
                }
            }
        },
        methods:{
            onEditorBlur(){//失去焦点事件
            },
            onEditorFocus(){//获得焦点事件
            },
            onEditorChange(){//内容改变事件
            }
        }
    }
</script>

果然生效了只显示了我写在toolbar里面的模块
这里写图片描述

那么toolbar工具栏对应功能的模块名是什么呢我继续往下看文档发现大致上有以下的功能

背景颜色 - background
加粗- bold
颜色 - color
字体 - font
内联代码 - code
斜体 - italic
链接 - link
大小 - size
删除线 - strike
上标/下标 - script
下划线 - underline
引用- blockquote
标题 - header
缩进 - indent
列表 - list
文本对齐 - align
文本方向 - direction
代码块 - code-block
公式 - formula
图片 - image
视频 - video
清除字体样式- clean

然而我试着直接引入发现有部分的图标并没有显示；
然后我发现他有些如list这种列表应该是有默认值，我在很后面的文档里发现了这个默认格式规范这个官方文档也是个坑内容不写到一块的还好我聪明机智；

这里写图片描述

大致上分为这几类：

1.只需要填写功能名的
加粗 - bold；
斜体 - italic
下划线 - underline
删除线 - strike
引用- blockquote
代码块 - code-block
公式 - formula
图片 - image
视频 - video
清除字体样式- clean
这一类的引用 直接['name','name']这种格式就好了

2.需要有默认值的
标题 - header  
[{ 'header': 1 }, { 'header': 2 }] 值字体大小

列表 - list 
[{ 'list': 'ordered'}, { 'list': 'bullet' }], 值ordered，bullet

上标/下标 - script 
 [{ 'script': 'sub'}, { 'script': 'super' }],  值sub，super

缩进 - indent
[{ 'indent': '-1'}, { 'indent': '+1' }], 值-1，+1等

文本方向 - direction
[{ 'direction': 'rtl' }],    值rtl

这部分如图所示会填写的内容对应提供的值展示功能的图标如果多个值他家就显示多个图标
这里写图片描述

3.有多个值 以下拉列表形式显示

大小 - size
 [{ 'size': ['small', false, 'large', 'huge'] }],  

标题 - header
[{ 'header': [1, 2, 3, 4, 5, 6, false] }],

这部分显示如图所示以下拉列形式显示
这里写图片描述

4.有系统默认值的功能只需填写一个空数组 就会有出现默认的选项
颜色 - color
背景颜色 - background
字体 - font
文本对齐 - align
他们的格式都是
[{ 'color': [] }, { 'background': [] }], 
[{ 'font': [] }],
[{ 'align': [] }]
这种格式

效果如下会有默认值出现
这里写图片描述

toolbar自定义工具栏就是这样咯剩下的就是根据填写功能到options的modules里就可以了
这里写图片描述

vue中使用vue-quill-editor富文本编辑器，自定义toolbar修改工具栏options

猜你喜欢