插件窝 干货文章 分享推荐一款好用的TP富文本编辑器-CKEditor

分享推荐一款好用的TP富文本编辑器-CKEditor

amp 39 ckeditor strong 303    来源:    2024-10-27

本篇文章给大家推荐一款炒鸡好用的thinkphp富文本编辑器--ckeditor,下面给大家介绍一下使用ckeditor的方法,希望对大家有所帮助!

最近一直在做Thinkphp后端开发,之前都是使用layui的富文本编辑器,layui的优点是简单易用,但缺点也比较明显,就是编辑器功能比较少,无意中发现别人的项目里使用的是CKEditor富文本编辑器,感觉还阔以!下面让我们一起来学习如何使用CKEditor。【相关教程推荐:thinkphp框架】

Ckeditor4下载地址(本教程选择的是CKEditor 4.16版本):https://ckeditor.com/ckeditor-4/download/

一、在页面中引入ckeditor核心文件ckeditor.js 

<script type="text/javascript" src="ckeditor/ckeditor.js"></script>

二、在使用编辑器的地方插入HTML控件

<textarea  id="content" name="content" cols="30" rows="2"></textarea>

三、将相应的控件替换成编辑器代码

<script type="text/javascript">
var editor;
window.onload = function()
{
    editor = CKEDITOR.replace( &#39;content&#39;, {
            filebrowserImageUploadUrl : &#39;{:url("@admin/article/uploadPic")}&#39;,//上传图片的后端URL地址
            image_previewText : &#39; &#39;///去掉图片上传预览区域显示的文字
    });
};
</script>

四、开启上传功能(上传功能被隐藏了,所以需要开启)

在ckeditor/plugins/image/dialogs/image.js文件中,搜索:id:"Upload",hidden:!0,把 !0改成false

五、thinkphp后端上传文件的方法

4.10版本之后,官方文档要求图片上传成功后,返回json格式,示例如下:

上传成功返回:

{
    "uploaded": 1,
    "fileName": "demo.jpg",
    "url": "/files/demo.jpg"
}

{
    "uploaded": 1,
    "fileName": "test.jpg",
    "url": "/files/test.jpg",
    "error": {
        "message": "A file with the same name already exists. The uploaded file was renamed to \"test.jpg\"."
    }
}

上传失败返回:

{
    "uploaded": 0,
    "error": {
        "message": "The file is too big."
    }
}

后端上传图片的代码:

/**
    * @name=&#39;上传图片&#39;    
    */
    public function uploadPic()
    {
        //注明:ckeditor是使用ajax上传图片,而不是用表单提交,因此不能使用request()->file()接收图片,只能用$_FILES
        $name = $_FILES[&#39;upload&#39;][&#39;name&#39;]; 
        $size = $_FILES[&#39;upload&#39;][&#39;size&#39;];
        if($size  > 1024*2*1000){
            $arr= array(
                "uploaded" => 0,
                "error"    => "上传的图片大小不能超过2M"
            );
            exit(json_encode($arr));
        }
        $extension = pathInfo($name,PATHINFO_EXTENSION);
        $types = array("jpg","bmp","gif","png");        
        if(in_array($extension,$types)){ 
            //以日期为文件夹名,如public/uploads/20210327/
            $dateFolder = date("Ymd",time());
            $path = ROOT_PATH . &#39;public/uploads/&#39;.$dateFolder.DS;
            if(!file_exists($path)){
                mkdir($path,0777,true);
            }       
            $img_name  = str_replace(&#39;.&#39;,&#39;&#39;,uniqid("",TRUE)).".".$extension; //图片名称
            $save_path = $path.$img_name; //保存路径 
            $img_path  = &#39;/uploads/&#39;.$dateFolder.DS.$img_name; //图片路径 
            move_uploaded_file($_FILES[&#39;upload&#39;][&#39;tmp_name&#39;],$save_path);   
            $arr= array(
                "uploaded" => 1,
                "fileName" => $img_name,
                "url"      => $img_path
            );
        }else{ 
            $arr= array(
                "uploaded" => 0,
                "error"    => "图片格式不正确(只能上传.jpg/.gif/.bmp/.png类型的文件)"
            );       
        } 
        return json_encode($arr);
    }

六、js里获取ckeditor里的内容

<script type="text/javascript">
var editor;
$(function() {
    editor = CKEDITOR.replace(&#39;content&#39;);
})
editor.document.getBody().getText();//取得纯文本
editor.document.getBody().getHtml();//取得html文本
</script>

七、使用颜色插件

1、需要下载三个插件(缺一不可),下载地址:

https://ckeditor.com/cke4/addon/colorbutton

https://ckeditor.com/cke4/addon/floatpanel

https://ckeditor.com/cke4/addon/panelbutton

2、下载好的插件解压到ckeditor\plugins目录里

3、加载插件

方式一:在ckeditor/config.js文件中,添加插件的配置,如下:

CKEDITOR.editorConfig = function( config ) {

    ...省略前面的代码

    //加载插件
    config.extraPlugins = &#39;colorbutton,panelbutton,floatpanel&#39;;
}

方式二:在js里初始化editor时,添加插件的配置

<script type="text/javascript">
var editor;
window.onload = function()
{
    editor = CKEDITOR.replace( &#39;content&#39;, {
            filebrowserImageUploadUrl : &#39;{:url("@admin/article/uploadPic")}&#39;,//上传图片的后端URL地址
            image_previewText : &#39; &#39;,///去掉图片上传预览区域显示的文字
            extraPlugins: &#39;colorbutton&#39;,//使用颜色插件
    });
};
</script>

八、自定义工具栏配置

在ckeditor/config.js文件中设置

CKEDITOR.editorConfig = function( config ) {
    //工具栏设置
    config.toolbar = &#39;MyToolbar&#39;;
    config.toolbar_Full = [
        { name: &#39;document&#39;, items : [ &#39;Source&#39;,&#39;-&#39;,&#39;Save&#39;,&#39;NewPage&#39;,&#39;DocProps&#39;,&#39;Preview&#39;,&#39;Print&#39;,&#39;-&#39;,&#39;Templates&#39; ] },
        { name: &#39;clipboard&#39;, items : [ &#39;Cut&#39;,&#39;Copy&#39;,&#39;Paste&#39;,&#39;PasteText&#39;,&#39;PasteFromWord&#39;,&#39;-&#39;,&#39;Undo&#39;,&#39;Redo&#39; ] },
        { name: &#39;editing&#39;, items : [ &#39;Find&#39;,&#39;Replace&#39;,&#39;-&#39;,&#39;SelectAll&#39;,&#39;-&#39;,&#39;SpellChecker&#39;, &#39;Scayt&#39; ] },
        { name: &#39;forms&#39;, items : [ &#39;Form&#39;, &#39;Checkbox&#39;, &#39;Radio&#39;, &#39;TextField&#39;, &#39;Textarea&#39;, &#39;Select&#39;, &#39;Button&#39;, &#39;ImageButton&#39;, 
            &#39;HiddenField&#39; ] },
        &#39;/&#39;,
        { name: &#39;basicstyles&#39;, items : [ &#39;Bold&#39;,&#39;Italic&#39;,&#39;Underline&#39;,&#39;Strike&#39;,&#39;Subscript&#39;,&#39;Superscript&#39;,&#39;-&#39;,&#39;RemoveFormat&#39; ] },
        { name: &#39;paragraph&#39;, items : [ &#39;NumberedList&#39;,&#39;BulletedList&#39;,&#39;-&#39;,&#39;Outdent&#39;,&#39;Indent&#39;,&#39;-&#39;,&#39;Blockquote&#39;,&#39;CreateDiv&#39;,
        &#39;-&#39;,&#39;JustifyLeft&#39;,&#39;JustifyCenter&#39;,&#39;JustifyRight&#39;,&#39;JustifyBlock&#39;,&#39;-&#39;,&#39;BidiLtr&#39;,&#39;BidiRtl&#39; ] },
        { name: &#39;links&#39;, items : [ &#39;Link&#39;,&#39;Unlink&#39;,&#39;Anchor&#39; ] },
        { name: &#39;insert&#39;, items : [ &#39;Image&#39;,&#39;Flash&#39;,&#39;Table&#39;,&#39;HorizontalRule&#39;,&#39;Smiley&#39;,&#39;SpecialChar&#39;,&#39;PageBreak&#39;,&#39;Iframe&#39; ] },
        &#39;/&#39;,
        { name: &#39;styles&#39;, items : [ &#39;Styles&#39;,&#39;Format&#39;,&#39;Font&#39;,&#39;FontSize&#39; ] },
        { name: &#39;colors&#39;, items : [ &#39;TextColor&#39;,&#39;BGColor&#39; ] },
        { name: &#39;tools&#39;, items : [ &#39;Maximize&#39;, &#39;ShowBlocks&#39;,&#39;-&#39;,&#39;About&#39; ] }
    ]; 
    config.toolbar_Basic = [
        [&#39;Bold&#39;, &#39;Italic&#39;, &#39;-&#39;, &#39;NumberedList&#39;, &#39;BulletedList&#39;, &#39;-&#39;, &#39;Link&#39;, &#39;Unlink&#39;,&#39;-&#39;,&#39;About&#39;]
    ];
    //自定义
    config.toolbar_MyToolbar =[
        //加粗    斜体,    下划线    穿过线    下标字        上标字
        [&#39;Bold&#39;,&#39;Italic&#39;,&#39;Underline&#39;,&#39;Strike&#39;,&#39;Subscript&#39;,&#39;Superscript&#39;],
        // 数字列表        实体列表         减小缩进  增大缩进
        [&#39;NumberedList&#39;,&#39;BulletedList&#39;,&#39;-&#39;,&#39;Outdent&#39;,&#39;Indent&#39;],
        //   左对齐        居中对齐        右对齐        两端对齐
        [&#39;JustifyLeft&#39;,&#39;JustifyCenter&#39;,&#39;JustifyRight&#39;,&#39;JustifyBlock&#39;],
        //超链接  取消超链接 锚点
        [&#39;Link&#39;,&#39;Unlink&#39;,&#39;Anchor&#39;],
        //图片    flash    表格       水平线        表情     特殊字符      分页符
        [&#39;Image&#39;,&#39;Flash&#39;,&#39;Table&#39;,&#39;HorizontalRule&#39;,&#39;Smiley&#39;,&#39;SpecialChar&#39;,&#39;PageBreak&#39;],
        &#39;/&#39;,
        // 样式     格式    字体   字体大小
        [&#39;Styles&#39;,&#39;Format&#39;,&#39;Font&#39;,&#39;FontSize&#39;],
        //文本颜色   背景颜色
        [&#39;TextColor&#39;,&#39;BGColor&#39;],
        //全屏         显示区块         源码
        [&#39;Maximize&#39;, &#39;ShowBlocks&#39;,&#39;-&#39;,&#39;Source&#39;]
    ],
    config.format_tags = &#39;p;h1;h2;h3;h4;h5;h6;pre&#39;;
    config.removeButtons = &#39;Underline,Subscript,Superscript&#39;;
    config.removeDialogTabs = &#39;image:advanced;link:advanced&#39;;
    //加载插件
    config.extraPlugins = &#39;colorbutton,panelbutton,floatpanel&#39;; 
};

更多编程相关知识,请访问:编程视频!!