Python的Flask框架中集成CKeditor富文本編輯器的教程

CKeditor是目前最優秀的可見即可得網頁編輯器之一,它採用JavaScript編寫。具備功能強大、配置容易、跨瀏覽器、支持多種編程語言、開源等特點。它非常流行,互聯網上很容易找到相關技術文檔,國內許多WEB項目和大型網站均採用了CKeditor。

下載CKeditor
訪問CKeditor官方網站,進入下載頁面,選擇Standard Package(一般情況下功能足夠用了),然後點擊Download CKEditor按鈕下載ZIP格式的安裝文件。如果你想嘗試更多的功能,可以選擇下載Full Package。

下載好CKeditor之後,解壓到Flask項目static/ckeditor目錄即可。

在Flask項目中使用CKeditor
在Flask項目中使用CKeditor只需要執行兩步就可以了:

<!DOCTYPE html>
<html>
  <head>
    <title>A Simple Page with CKEditor</title>
    <!-- 請確保CKEditor文件路徑正確 -->
    <script src="{{ url_for('static', filename='ckeditor/ckeditor.js') }}"></script>
  </head>
  <body>
    <form>
      <textarea name="editor1" id="editor1" rows="10" cols="80">
        This is my textarea to be replaced with CKEditor.
      </textarea>
      <script>
        // 用CKEditor替換<textarea id="editor1">
        // 使用默認配置
        CKEDITOR.replace('editor1');
      </script>
    </form>
  </body>
</html>

因爲CKeditor足夠優秀,所以第二步也可只爲追加名爲ckeditor的class屬性值,CKeditor就會自動將其替換。例如:

<!DOCTYPE html>
<html>
  <head>
    <title>A Simple Page with CKEditor</title>
    <!-- 請確保CKEditor文件路徑正確 -->
    <script src="{{ url_for('static', filename='ckeditor/ckeditor.js') }}"></script>
  </head>
  <body>
    <form>
      <textarea name="editor1" id="editor1" class="ckeditor" rows="10" cols="80">
        This is my textarea to be replaced with CKEditor.
      </textarea>
    </form>
  </body>
</html>

CKEditor腳本文件也可以引用CDN上的文件,下面給出幾個參考鏈接:

<script src="//cdn.ckeditor.com/4.4.6/basic/ckeditor.js"></script>
 基礎版(迷你版)
<script src="//cdn.ckeditor.com/4.4.6/standard/ckeditor.js"></script>

標準版

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

完整版
開啓上傳功能
默認配置下,CKEditor是沒有開啓上傳功能的,要開啓上傳功能,也相當的簡單,只需要簡單修改配置即可。下面來看看幾個相關的配置值:

filebrowserUploadUrl :文件上傳路徑。若設置了,則上傳按鈕會出現在鏈接、圖片、Flash對話窗口。
filebrowserImageUploadUrl : 圖片上傳路徑。若不設置,則使用filebrowserUploadUrl值。
filebrowserFlashUploadUrl : Flash上傳路徑。若不設置,則使用filebrowserUploadUrl值。
爲了方便,這裏我們只設置filebrowserUploadUrl值,其值設爲/ckupload/(後面會在Flask中定義這個URL)。

推薦我們的Python學習扣qun:913066266 ,看看前輩們是如何學習的!從基礎的python腳本到web開發、爬蟲、django、數據挖掘等【PDF,實戰源碼】,零基礎到項目實戰的資料都有整理。送給每一位python的小夥伴!每天都有大牛定時講解Python技術,分享一些學習的方法和需要注意的小細節,點擊加入我們的 python學習者聚集地
設置配置值主要使用2種方法:

方法1:通過CKEditor根目錄的配置文件config.js來設置:

CKEDITOR.editorConfig = function( config ) {
  // ...
  // file upload url
  config.filebrowserUploadUrl = '/ckupload/';
  // ...
};

方法2:將設置值放入作爲參數放入CKEDITOR.replace():

<script>
CKEDITOR.replace('editor1', {
  filebrowserUploadUrl: '/ckupload/',
});
</script>

Flask處理上傳請求
CKEditor上傳功能是統一的接口,即一個接口可以處理圖片上傳、文件上傳、Flash上傳。先來看看代碼:

def gen_rnd_filename():
  filename_prefix = datetime.datetime.now().strftime('%Y%m%d%H%M%S')
  return '%s%s' % (filename_prefix, str(random.randrange(1000, 10000)))
 
@app.route('/ckupload/', methods=['POST'])
def ckupload():
  """CKEditor file upload"""
  error = ''
  url = ''
  callback = request.args.get("CKEditorFuncNum")
  if request.method == 'POST' and 'upload' in request.files:
    fileobj = request.files['upload']
    fname, fext = os.path.splitext(fileobj.filename)
    rnd_name = '%s%s' % (gen_rnd_filename(), fext)
    filepath = os.path.join(app.static_folder, 'upload', rnd_name)
    # 檢查路徑是否存在,不存在則創建
    dirname = os.path.dirname(filepath)
    if not os.path.exists(dirname):
      try:
        os.makedirs(dirname)
      except:
        error = 'ERROR_CREATE_DIR'
    elif not os.access(dirname, os.W_OK):
      error = 'ERROR_DIR_NOT_WRITEABLE'
    if not error:
      fileobj.save(filepath)
      url = url_for('static', filename='%s/%s' % ('upload', rnd_name))
  else:
    error = 'post error'
  res = """
 
<script type="text/javascript">
 window.parent.CKEDITOR.tools.callFunction(%s, '%s', '%s');
</script>
 
""" % (callback, url, error)
  response = make_response(res)
  response.headers["Content-Type"] = "text/html"

上傳文件的獲取及保存部分比較簡單,是標準的文件上傳。這裏主要講講上傳成功後如何回調的問題。

CKEditor文件上傳之後,服務端返回HTML文件,HTML文件包含JAVASCRIPT腳本,JS腳本會調用一個回調函數,若無錯誤,回調函數將返回的URL轉交給CKEditor處理。

這3個參數依次是:

CKEditorFuncNum : 回調函數序號。CKEditor通過URL參數提交給服務端
URL : 上傳後文件的URL
Error : 錯誤信息。若無錯誤,返回空字符串
使用藍本
在大型應用中經常會使用藍本,在藍本視圖中集成CKEditor的步驟和app視圖基本相同。

  1. 創建藍本時需指明藍本static目錄的絕對路徑
    . demo = Blueprint('demo', static_folder="/path/to/static")
  2. 對應url需加上藍本端點
<script src="{{url_for('.static', filename='ckeditor/ckeditor.js')}}"></script>
 
<script type="text/javascript">
  CKEDITOR.replace(
    "ckeditor_demo", {
      filebrowserUploadUrl: './ckupload/'
    }
  );
</script>
  1. 設置endpoint端點值
response = form.upload(endpoint=demo)
發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章