# editor

富文本编辑器,可以对图片、文字进行编辑。

# 兼容性

Web 微信小程序 Android iOS
4.0 4.41 x x

App平台推荐使用web-view来加载网页版的富文本编辑器。不限于uni-app的editor组件,使用任意网页版富文本编辑器都可以。

# 属性

名称 类型 默认值 兼容性 描述
read-only boolean -
设置编辑器为只读。
placeholder string -
提示信息。
show-img-size boolean -
点击图片时显示图片大小控件。
show-img-toolbar boolean -
点击图片时显示工具栏控件。
show-img-resize string -
点击图片时显示修改尺寸控件。
@ready (event: UniEvent) => void -
编辑器初始化完成时触发
@focus (event: UniEvent) => void -
编辑器聚焦时触发,event.detail = {html, text, delta}
@blur (event: UniEvent) => void -
编辑器失去焦点时触发,detail = {html, text, delta}
@input (event: UniEvent) => void -
编辑器内容改变时触发,detail = {html, text, delta}
@statuschange (event: UniEvent) => void -
通过 Context 方法改变编辑器内样式时触发,返回选区已设置的样式
enable-formats Array.<string> -
-

# 示例

hello uni-app x

Template

Script

<template>
  <view class="container">
    <view class="page-body">
      <view class='wrapper'>
        <view class='toolbar' @tap="format">
          <view :class="formats.bold ? 'ql-active' : ''" class="iconfont icon-zitijiacu" data-name="bold"></view>
          <view :class="formats.italic ? 'ql-active' : ''" class="iconfont icon-zitixieti" data-name="italic"></view>
          <view :class="formats.underline ? 'ql-active' : ''" class="iconfont icon-zitixiahuaxian"
            data-name="underline"></view>
          <view :class="formats.strike ? 'ql-active' : ''" class="iconfont icon-zitishanchuxian" data-name="strike">
          </view>

          <view :class="formats.align === 'left' ? 'ql-active' : ''" class="iconfont icon-zuoduiqi" data-name="align"
            data-value="left"></view>

          <view :class="formats.align === 'center' ? 'ql-active' : ''" class="iconfont icon-juzhongduiqi"
            data-name="align" data-value="center"></view>
          <view :class="formats.align === 'right' ? 'ql-active' : ''" class="iconfont icon-youduiqi" data-name="align"
            data-value="right"></view>
          <view :class="formats.align === 'justify' ? 'ql-active' : ''" class="iconfont icon-zuoyouduiqi"
            data-name="align" data-value="justify"></view>

          <view :class="formats.lineHeight ? 'ql-active' : ''" class="iconfont icon-line-height" data-name="lineHeight"
            data-value="2"></view>
          <view :class="formats.letterSpacing ? 'ql-active' : ''" class="iconfont icon-Character-Spacing"
            data-name="letterSpacing" data-value="2em"></view>
          <view :class="formats.marginTop ? 'ql-active' : ''" class="iconfont icon-722bianjiqi_duanqianju"
            data-name="marginTop" data-value="20px"></view>
          <view :class="formats.marginBottom ? 'ql-active' : ''" class="iconfont icon-723bianjiqi_duanhouju"
            data-name="marginBottom" data-value="20px"></view>

          <view :class="formats.fontFamily ? 'ql-active' : ''" class="iconfont icon-font" data-name="fontFamily"
            data-value="Pacifico"></view>
          <view :class="formats.fontSize === '24px' ? 'ql-active' : ''" class="iconfont icon-fontsize"
            data-name="fontSize" data-value="24px"></view>
          <view :class="formats.color === '#0000ff' ? 'ql-active' : ''" class="iconfont icon-text_color"
            data-name="color" data-value="#0000ff"></view>
          <view :class="formats.backgroundColor === '#00ff00' ? 'ql-active' : ''" class="iconfont icon-fontbgcolor"
            data-name="backgroundColor" data-value="#00ff00"></view>

          <view class="iconfont icon--checklist" data-name="list" data-value="check"></view>
          <view :class="formats.list === 'ordered' ? 'ql-active' : ''" class="iconfont icon-youxupailie"
            data-name="list" data-value="ordered"></view>
          <view :class="formats.list === 'bullet' ? 'ql-active' : ''" class="iconfont icon-wuxupailie" data-name="list"
            data-value="bullet"></view>


          <view class="iconfont icon-outdent" data-name="indent" data-value="-1"></view>
          <view class="iconfont icon-indent" data-name="indent" data-value="+1"></view>


          <view :class="formats.header === 1 ? 'ql-active' : ''" class="iconfont icon-format-header-1"
            data-name="header" :data-value="1"></view>
          <view :class="formats.script === 'sub' ? 'ql-active' : ''" class="iconfont icon-zitixiabiao"
            data-name="script" data-value="sub"></view>
          <view :class="formats.script === 'super' ? 'ql-active' : ''" class="iconfont icon-zitishangbiao"
            data-name="script" data-value="super"></view>

          <view :class="formats.direction === 'rtl' ? 'ql-active' : ''" class="iconfont icon-direction-rtl"
            data-name="direction" data-value="rtl"></view>

          <view class="iconfont icon-date" @tap="insertDate"></view>
          <view class="iconfont icon-fengexian" @tap="insertDivider"></view>
          <view class="iconfont icon-charutupian" @tap="chooseInsertImage"></view>
          <view class="iconfont icon-clearedformat" @tap="removeFormat"></view>
          <view class="iconfont icon-undo" @tap="undo"></view>
          <view class="iconfont icon-redo" @tap="redo"></view>
          <view class="iconfont icon-shanchu" @tap="clearShowModal"></view>
        </view>

        <view class="editor-wrapper">
          <editor id="editor" class="ql-container" placeholder="开始输入..." show-img-size show-img-toolbar show-img-resize
            @statuschange="onStatusChange" :read-only="readOnly" @ready="onEditorReady">
          </editor>
        </view>
        <view>
          <button @tap="getCon">控制台打印文本内容</button>
        </view>
      </view>
    </view>
  </view>
</template>



<style>
  @import "./editor-icon.css";

  .page-body {
    height: calc(100vh - var(--window-top) - var(--status-bar-height));
  }

  .wrapper {
    height: 100%;
  }

  .editor-wrapper {
    height: calc(100vh - var(--window-top) - var(--status-bar-height) - 140px - 46px);
    background: #fff;
  }

  .iconfont {
    display: inline-block;
    width: 30px;
    height: 30px;
    cursor: pointer;
    font-size: 20px;
    margin: 0px 6px;
    align-content: center;
  }

  .toolbar {
    box-sizing: border-box;
    border-bottom: 0;
    font-family: 'Helvetica Neue', 'Helvetica', 'Arial', sans-serif;
    flex-direction: row;
    flex-wrap: wrap;
    height: 140px;
    padding-left: 10px;
  }

  .ql-container {
    box-sizing: border-box;
    padding: 12px 15px;
    width: 100%;
    min-height: 30vh;
    height: 100%;
    font-size: 16px;
    line-height: 1.5;
  }

  .ql-active {
    color: #06c;
  }
</style>

# 参见