萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

解決 TinyMCE 編輯器內容無法通過 AjaxForm 提交的問題:form-pre-serialize 事件觸發 triggerSave

問題現象

使用 TinyMCE 富文本編輯器時,通過 jQuery Form Plugin (ajaxForm) 提交表單,首次提交無法獲取編輯器內容,第二次才正常。原因:TinyMCE 內容在 iframe 或 div 中,未同步回原始 <textarea>。

根因分析

jQuery Form Plugin 在序列化表單數據前觸發 form-pre-serialize 事件,此時若手動調用 tinyMCE.triggerSave() 將編輯器內容同步到 textarea,即可解決。

標準解決方案

// 1. 初始化 TinyMCE
tinymce.init({
    selector: '#content',
    // ... 其他配置
});

// 2. 綁定 ajaxForm 並監聽 form-pre-serialize
$('#commentForm').ajaxForm({
    // 選項...
}).on('form-pre-serialize', function() {
    // 關鍵:序列化前同步編輯器內容
    tinymce.triggerSave();
});

原理說明

// jquery.form.js 內部核心邏輯 (簡化)
var veto = {};
// 觸發 form-pre-serialize,允許外部修改表單數據
$form.trigger('form-pre-serialize', [$form, options, veto]);
if (veto.veto) return; // 可取消提交

// 隨後調用 $form.serialize() 或 $form.serializeArray()
// 此時 textarea 已包含最新內容

兼容 FCKEditor / CKEditor

// CKEditor 4
$('#form').on('form-pre-serialize', function() {
    for (var instanceName in CKEDITOR.instances) {
        CKEDITOR.instances[instanceName].updateElement();
    }
});

// CKEditor 5 (需根據實例調用)
$('#form').on('form-pre-serialize', function() {
    if (window.editor) editor.updateSourceElement();
});

最佳實踐封裝

$.fn.ajaxFormWithEditors = function(options) {
    return this.each(function() {
        var $form = $(this);
        $form.on('form-pre-serialize', function() {
            // 統一同步所有主流編輯器
            if (window.tinymce) tinymce.triggerSave();
            if (window.CKEDITOR) {
                Object.values(CKEDITOR.instances).forEach(inst => inst.updateElement());
            }
            // 其他編輯器...
        });
        $form.ajaxForm(options);
    });
};

// 使用
$('#myForm').ajaxFormWithEditors({ target: '#result' });

注意事項

  • 確保 tinymce.triggerSave() 在 serialize() 之前執行,form-pre-serialize 事件保證了順序。
  • 若使用 ajaxSubmit() 手動提交,同樣會觸發該事件。
  • TinyMCE 5+ 同樣支持 triggerSave()。
copyright © 萬盛學電腦網 all rights reserved