CKeditor是目前最優(yōu)秀的可見即可得網(wǎng)頁編輯器之一,它采用JavaScript編寫。具備功能強大、配置容易、跨瀏覽器、支持多種編程語言、開源等特點。它非常流行,互聯(lián)網(wǎng)上很容易找到相關(guān)技術(shù)文檔,國內(nèi)許多WEB項目和大型網(wǎng)站均采用了CKeditor。
下載CKeditor
訪問CKeditor官方網(wǎng)站,進入下載頁面,選擇Standard Package(一般情況下功能足夠用了),然后點擊Download CKEditor按鈕下載ZIP格式的安裝文件。如果你想嘗試更多的功能,可以選擇下載Full Package。
下載好CKeditor之后,解壓到Flask項目static/ckeditor目錄即可。
在Flask項目中使用CKeditor
在Flask項目中使用CKeditor只需要執(zhí)行兩步就可以了:
在<script>標簽引入CKeditor主腳本文件。可以引入本地的文件,也可以引用CDN上的文件。
使用CKEDITOR.replace()把現(xiàn)存的<textarea>標簽替換成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足夠優(yōu)秀,所以第二步也可只為<textarea>追加名為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="http://cdn.ckeditor.com/4.4.6/basic/ckeditor.js"></script>
基礎(chǔ)版(迷你版)
<script src="http://cdn.ckeditor.com/4.4.6/standard/ckeditor.js"></script>
標準版
<script src="http://cdn.ckeditor.com/4.4.6/full/ckeditor.js"></script>
完整版
開啟上傳功能
默認配置下,CKEditor是沒有開啟上傳功能的,要開啟上傳功能,也相當?shù)暮唵危恍枰唵涡薷呐渲眉纯伞O旅鎭砜纯磶讉€相關(guān)的配置值:
為了方便,這里我們只設(shè)置filebrowserUploadUrl值,其值設(shè)為/ckupload/(后面會在Flask中定義這個URL)。
設(shè)置配置值主要使用2種方法:
方法1:通過CKEditor根目錄的配置文件config.js來設(shè)置:
CKEDITOR.editorConfig = function( config ) { // ... // file upload url config.filebrowserUploadUrl = '/ckupload/'; // ...};方法2:將設(shè)置值放入作為參數(shù)放入CKEDITOR.replace():
<script>CKEDITOR.replace('editor1', { filebrowserUploadUrl: '/ckupload/',});</script>Flask處理上傳請求
CKEditor上傳功能是統(tǒng)一的接口,即一個接口可以處理圖片上傳、文件上傳、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) # 檢查路徑是否存在,不存在則創(chuàng)建 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" return response上傳文件的獲取及保存部分比較簡單,是標準的文件上傳。這里主要講講上傳成功后如何回調(diào)的問題。
CKEditor文件上傳之后,服務(wù)端返回HTML文件,HTML文件包含JAVASCRIPT腳本,JS腳本會調(diào)用一個回調(diào)函數(shù),若無錯誤,回調(diào)函數(shù)將返回的URL轉(zhuǎn)交給CKEditor處理。
這3個參數(shù)依次是:
使用藍本
在大型應(yīng)用中經(jīng)常會使用藍本,在藍本視圖中集成CKEditor的步驟和app視圖基本相同。
1. 創(chuàng)建藍本時需指明藍本static目錄的絕對路徑
demo = Blueprint('demo', static_folder="/path/to/static")2. 對應(yīng)url需加上藍本端點
<script src="{{url_for('.static', filename='ckeditor/ckeditor.js')}}"></script><script type="text/javascript"> CKEDITOR.replace( "ckeditor_demo", { filebrowserUploadUrl: './ckupload/' } );</script>3. 設(shè)置endpoint端點值
response = form.upload(endpoint=demo)
新聞熱點
疑難解答
圖片精選