Skip to content

mHalo/mhalo.kindeditor

Repository files navigation

MHalo.KindEditor

Downloads Version License

🔵 What is KindEditor?

KindEditor is a lightweight, Open Source(LGPL), cross browser, web based WYSIWYG HTML editor. KindEditor has the ability to convert standard textareas to rich text editing.
Official site: http://kindeditor.net/

🔴 Break Changes

  • @v4.4.15
    工具栏图标文件本地化(不再引用iconfont线上地址)
    图标字体路径: themes -> default -> fonts/*,图标样式包含在default.css文件中
    点此查看更新详情

  • @v4.4.8
    上传类接口返回数据格式处理逻辑更新(保持kindeditor默认格式处理);
    如遇到接口返回数据格式不同的情况,可以增加[uploadResponseFilter]参数配置进行处理;
    点此查看更新详情

🟠 Bug 和需求反馈

如果想要反馈 Bug、提供意见,可以创建 Github issue 或 添加微信(备注KE) 联系,十分感谢!

🟢 MHalo.KindEditor

MHalo.KindEditor在Kindeditor(https://github.com/kindsoft/kindeditor )的基础上,进行了界面的美化,以及部分插件的优化修改。 具体使用方式与kindeditor无较大差异,可参考http://kindeditor.net/doc.php

使用前请移步了解更新日志: 点此查看

image


特点:

👉. 基于theme/default的样式更新,使用iconfont更新图标样式

自定义组件图标添加方式:

  1. 移步 https://www.iconfont.cn/ 下载所需图标的svg/png文件
  2. 根据图标样式名规则(.ke-icon-[插件定义的name])定义样式:
    以插件plugin-demo为例(注意:关于background的相关样式设置,请务必添加 !important )
.ke-icon-plugin-demo{
    background: url(./icons-path/plugin.svg) center center no-repeat!important;
    background-size: auto 80%!important;
}

👉. KindEditor工具栏便捷配置,可使用K.Tools.AllK.Tools.NormalK.Tools.SmallK.Tools.Mini进行配置

KindEditor.ready(function (K) {
    var options = {
        items: K.Tools.All,
        //或基于某个默认配置增加自定义插件
        items: K.Tools.Mini.concat(['plugin-demo']),
    };
    var contentEditor = K.create('#editor', options);
});
Normal Small Mini
image image image

👉. Image-Uploader图片上传优化(包含多图上传、单图上传)

↦ 单图上传弃用了form提交的方式,多图上传弃用了flash的方式,统一使用webuploader进行上传。
↦ 由于webuploader中使用了jquery,但jquery体量较大,又考虑到在vue中使用的情况,所以将zepto取必须模块封装在了对应模块中,后期会考虑使用现代浏览器支持的方式自行构建。
↦ 上传时支持携带formData和Headers,支持客户端限制上传文件大小及文件类型。

> options 

uploadJson: '/handler/upload-test?dir=image',
uploadHeader:{
    corefx: 'mhalo'
},
extraFileUploadParams:{
    data: 'demo'
},
uploadFileSizeLimit: '5MB',
uploadFileTypeLimit: '*.jpg;*.gif;*.png;*.jpeg,*.bmp',
filePostName: 'imgFile',
uploadResponseFilter: function(response){
    return response.data
},

image

👉. Media类型上传,使用audio和video标签呈现

可设定controls、autoplay、preload、loop参数

image

👉. 可引入vite使用

kindeditor在发布时封装为了umd格式,为了支持es6 import的引用方式,包入口设置为了index.js,相关代码:
 
import './dist/kindeditor-all-min';
export default KindEditor ;
 
以此实现了es6 import;

包引入配置:

pnpm i mhalo.kindeditor

> vite.configjs 增加如下配置:

  optimizeDeps: {
    exclude: ['mhalo.kindeditor'], 
  },
  build: {
    commonjsOptions: { 
      exclude: ['mhalo.kindeditor'], 
      transformMixedEsModules: true,
    },
  },

🔗 MHalo.Vue-KindEditor `支持Vue3`

👉🏻 https://github.com/mHalo/mhalo.vue-kindeditor

Downloads Version License