Flask项目集成富文本编辑器CKeditor

430 查看

本文介绍如何在Flask项目中集成富文本编辑器CKeditor，并实现图片上传、文件上传、视频上传等功能。

CKeditor是目前最优秀的可见即可得网页编辑器之一，它采用JavaScript编写。具备功能强大、配置容易、跨浏览器、支持多种编程语言、开源等特点。它非常流行，互联网上很容易找到相关技术文档，国内许多WEB项目和大型网站均采用了CKeditor。

下载CKeditor

访问CKeditor官方网站，进入下载页面，选择Standard Package（一般情况下功能足够用了），然后点击Download CKEditor按钮下载ZIP格式的安装文件。如果你想尝试更多的功能，可以选择下载Full Package。

下载好CKeditor之后，解压到Flask项目static/ckeditor目录即可。

在Flask项目中使用CKeditor

在Flask项目中使用CKeditor只需要执行两步就可以了：

在<script>标签引入CKeditor主脚本文件。可以引入本地的文件，也可以引用CDN上的文件。
使用CKEDITOR.replace()把现存的<textarea>标签替换成CKEditor。

示例代码：

<!DOCTYPE html>

<html>

<head>

<title>A Simple Page with CKEditor</title>

</head>

<body>

<form>

This is my textarea to be replaced with CKEditor.

</textarea>

// 用CKEditor替换<textarea id="editor1">

// 使用默认配置

CKEDITOR.replace('editor1');

</script>

</form>

</body>

</html>

因为CKeditor足够优秀，所以第二步也可只为<textarea>追加名为ckeditor的class属性值，CKeditor就会自动将其替换。例如：

<!DOCTYPE html>

<html>

<head>

<title>A Simple Page with CKEditor</title>

</head>

<body>

<form>

This is my textarea to be replaced with CKEditor.

</textarea>

</form>

</body>

</html>

CKEditor脚本文件也可以引用CDN上的文件，下面给出几个参考链接：

基础版（迷你版）

1

<script src="//cdn.ckeditor.com/4.4.6/basic/ckeditor.js"></script>
标准版

1

<script src="//cdn.ckeditor.com/4.4.6/standard/ckeditor.js"></script>
完整版

1

<script src="//cdn.ckeditor.com/4.4.6/full/ckeditor.js"></script>

开启上传功能

默认配置下，CKEditor是没有开启上传功能的，要开启上传功能，也相当的简单，只需要简单修改配置即可。下面来看看几个相关的配置值：

filebrowserUploadUrl ：文件上传路径。若设置了，则上传按钮会出现在链接、图片、Flash对话窗口。
filebrowserImageUploadUrl ：图片上传路径。若不设置，则使用filebrowserUploadUrl值。
filebrowserFlashUploadUrl ： Flash上传路径。若不设置，则使用filebrowserUploadUrl值。

为了方便，这里我们只设置filebrowserUploadUrl值，其值设为/ckupload/（后面会在Flask中定义这个URL）。

设置配置值主要使用2种方法：

方法1：通过CKEditor根目录的配置文件config.js来设置:

CKEDITOR.editorConfig = function( config ) {

// ...

// file upload url

config.filebrowserUploadUrl = '/ckupload/';

// ...

};

方法2：将设置值放入作为参数放入CKEDITOR.replace():