Changes for page InplaceEditing

From 3.1 to 2.1 From 5.1 to 4.1

From version 4.1

edited by Nazzareno Pompei
on 28/10/2022 08:43

Change comment: Install extension [org.xwiki.platform:xwiki-platform-edit-ui/14.9]

To version 3.1

edited by Nazzareno Pompei
on 22/12/2021 09:31

Change comment: Install extension [org.xwiki.platform:xwiki-platform-edit-ui/13.10.1]

Raw
Rendered

Summary

Objects (2 modified, 0 added, 0 removed)
- XWiki.JavaScriptExtension[0]
- XWiki.UIExtensionClass[0]

Details

XWiki.JavaScriptExtension[0]

Code

@@ -87,24 +87,26 @@
          timestamp: new Date().getTime()
        };
        if (!forView) {
--        // We need the annotated HTML when editing in order to be able to protect the rendering transformations and to
++        // We need the annotated XHTML when editing in order to be able to protect the rendering transformations and to
          // be able to recreate the wiki syntax.
--        queryString.outputSyntax = 'annotatedhtml';
--        queryString.outputSyntaxVersion = '5.0'
++        queryString.outputSyntax = 'annotatedxhtml';
          // Currently, only the macro transformations are protected and thus can be edited.
          // See XRENDERING-78: Add markers to modified XDOM by Transformations/Macros
          queryString.transformations = 'macro';
        }
--      return Promise.resolve($.get(this.getURL('view'), queryString)).then(html => {
++      var thisXWikiDocument = this;
++      return $.get(this.getURL('view'), queryString).fail(function() {
++        new XWiki.widgets.Notification(l10n['edit.inplace.page.renderFailed'], 'error');
++      }).then(function(html) {
          // Render succeeded.
          var container = $('<div/>').html(html);
--        return $.extend(this, {
++        return $.extend(thisXWikiDocument, {
            renderedTitle: container.find('#document-title h1').html(),
            renderedContent: container.find('#xwikicontent').html()
          });
--      }).catch(() => {
--        new XWiki.widgets.Notification(l10n['edit.inplace.page.renderFailed'], 'error');
--        return Promise.reject(this);
++      }, function() {
++        // Render failed.
++        return thisXWikiDocument;
        });
      },
@@ -114,19 +114,20 @@
       * @return a promise that resolves to this document instance if the reload request succeeds
       */
      reload: function() {
--      return Promise.resolve($.getJSON(this.getRestURL(), {
++      var thisXWikiDocument = this;
++      return $.getJSON(this.getRestURL(), {
          // Make sure the response is not retrieved from cache (IE11 doesn't obey the caching HTTP headers).
          timestamp: new Date().getTime()
--      })).then(newXWikiDocument => {
++      }).then(function(newXWikiDocument) {
          // Reload succeeded.
          // Resolve the document reference.
--        this.documentReference = XWiki.Model.resolve(newXWikiDocument.id, XWiki.EntityType.DOCUMENT);
++        thisXWikiDocument.documentReference = XWiki.Model.resolve(newXWikiDocument.id, XWiki.EntityType.DOCUMENT);
          // We were able to load the document so it's not new.
--        this.isNew = false;
--        return $.extend(this, newXWikiDocument);
--      }).catch(() => {
++        thisXWikiDocument.isNew = false;
++        return $.extend(thisXWikiDocument, newXWikiDocument);
++      }, function() {
          // Reload failed.
--        return Promise.reject(this);
++        return thisXWikiDocument;
        });
      },
@@ -137,8 +137,9 @@
       * @return a promise that resolves to this document instance if the lock request succeeds
       */
      lock: function(action, force) {
++      var thisXWikiDocument = this;
        action = action || 'edit';
--      return Promise.resolve($.getJSON(this.getURL('get'), {
++      return $.getJSON(this.getURL('get'), {
          sheet: 'XWiki.InplaceEditing',
          action: 'lock',
          lockAction: action,
@@ -147,20 +147,20 @@
          outputSyntax: 'plain',
          // Make sure the response is not retrieved from cache (IE11 doesn't obey the caching HTTP headers).
          timestamp: new Date().getTime()
--      })).then(() => {
++      }).then(function() {
          // Lock succeeded.
--        this.locked = action;
--        return this;
--      }).catch(response => {
++        thisXWikiDocument.locked = action;
++        return thisXWikiDocument;
++      }, function(response) {
          // Lock failed.
--        delete this.locked;
++        delete thisXWikiDocument.locked;
          // Check if the user can force the lock.
          var lockConfirmation = response.responseJSON;
          if (response.status === 423 && lockConfirmation) {
            // The user can force the lock, but needs confirmation.
--          this.lockConfirmation = lockConfirmation;
++          thisXWikiDocument.lockConfirmation = lockConfirmation;
          }
--        return Promise.reject(this);
++        return thisXWikiDocument;
        });
      },
@@ -255,7 +255,7 @@
          $('#xwikicontent').removeAttr('tabindex');
          if (sectionId) {
            // Select the heading of the specified section.
--          $('#xwikicontent > #' + $.escapeSelector(sectionId)).each(function() {
++          $('#xwikicontent > #' + escapeSelector(sectionId)).each(function() {
              selectText(this);
            });
          }
@@ -263,6 +263,22 @@
      });
    };
++  var escapeSelector = function(selector) {
++    if (window.CSS && typeof CSS.escape === 'function') {
++      // Not supported by Internet Explorer.
++      return CSS.escape(selector);
++    } else if (typeof $.escapeSelector === 'function') {
++      // Added in jQuery 3.0
++      return $.escapeSelector(selector);
++    } else if (typeof selector === 'string') {
++      // Simple implementation.
++      // See https://learn.jquery.com/using-jquery-core/faq/how-do-i-select-an-element-by-an-id-that-has-characters-used-in-css-notation/
++      return selector.replace(/(:|\.|\[|\]|,|=|@)/g, '\\$1');
++    } else {
++      return selector;
++    }
++  };
++
    // We preserve the document data between edits in order to be able to know which document translation should be edited
    // (e.g. when the document translation is missing and we create it, the next edit session should target the created
    // translation).
@@ -270,11 +270,6 @@
      language: xcontext.locale
    }, xwikiDocumentAPI);
--  var setCurrentXWikiDocument = function(xwikiDocument) {
--    currentXWikiDocument = xwikiDocument;
--    return Promise.resolve(xwikiDocument);
--  };
--
    var editInPlace = function(options) {
      options = $.extend({
        afterEdit: function() {},
@@ -282,16 +282,11 @@
      }, options);
      $('#xwikicontent').addClass('loading');
      // Lock the document first.
--    return lock(currentXWikiDocument)
++    return lock(currentXWikiDocument).fail(options.lockFailed)
        // Then load the document only if we managed to lock it.
--      .then(load, xwikiDocument => {
--        options.lockFailed(xwikiDocument);
--        return Promise.reject(xwikiDocument);
++      .then(load)
        // Then load the editors only if we managed to load the document.
--      }).then(edit).then(xwikiDocument => {
--        options.afterEdit(xwikiDocument);
--        return xwikiDocument;
--      }).finally(() => {
++      .then(edit).done(options.afterEdit).always(function() {
          $('#xwikicontent').removeClass('loading');
        // Then wait for an action (save, cancel, reload) only if the editors were loaded successfuly.
        }).then(maybeSave)
@@ -299,39 +299,34 @@
        .then(unlock, unlock)
        // Finally view the document both when the edit ended with success and with a failure.
        .then(view, view)
--      // Update the current document for the next edit session.
--      .then(setCurrentXWikiDocument, setCurrentXWikiDocument);
++      .always(function(xwikiDocument) {
++        // Update the current document for the next edit session.
++        currentXWikiDocument = xwikiDocument;
++      });
    };
    var lock = function(xwikiDocument) {
--    return xwikiDocument.lock().catch(function(xwikiDocument) {
++    return xwikiDocument.lock().then(null, function(xwikiDocument) {
        // If the document was already locked then we need to ask the user if they want to force the lock.
        if (xwikiDocument.lockConfirmation) {
          var confirmation = xwikiDocument.lockConfirmation;
          delete xwikiDocument.lockConfirmation;
--        return maybeForceLock(confirmation).then(xwikiDocument.lock.bind(xwikiDocument, 'edit', true), function() {
++        return maybeForceLock(confirmation).then($.proxy(xwikiDocument, 'lock', 'edit', true), function() {
            // Cancel the edit action.
--          return Promise.reject(xwikiDocument);
++          return xwikiDocument;
          });
        } else {
          new XWiki.widgets.Notification(l10n['edit.inplace.page.lockFailed'], 'error');
--        return Promise.reject(xwikiDocument);
++        return xwikiDocument;
        }
      });
    };
    var maybeForceLock = function(confirmation) {
--    var deferred, promise = new Promise((resolve, reject) => {
--      deferred = {resolve, reject};
--    });
--    // We need the catch() to prevent the "Uncaught (in promise)" error log in the console.
--    promise.catch(() => {}).finally(() => {
--      // This flag is used by the Force Lock modal to know whether the promise is settled when the modal is closing.
--      deferred.settled = true;
--    });
++    var deferred = $.Deferred();
      // Reuse the confirmation modal once it is created.
      var modal = $('.force-edit-lock-modal');
--    if (!modal.length) {
++    if (modal.length === 0) {
        modal = createForceLockModal();
      }
      // Update the deferred that needs to be resolved or rejected.
@@ -347,7 +347,7 @@
      }
      // Show the confirmation modal.
      modal.modal('show');
--    return promise;
++    return deferred.promise();
    };
    var createForceLockModal = function() {
@@ -371,16 +371,16 @@
        '</div>'
      ].join(''));
      modal.find('.close').attr('aria-label', l10n['edit.inplace.close']);
--    modal.find('.modal-footer .btn-warning').on('click', function() {
++    modal.find('.modal-footer .btn-warning').click(function() {
        // The user has confirmed they want to force the lock.
        modal.data('deferred').resolve();
        modal.modal('hide');
      });
      modal.on('hide.bs.modal', function() {
--      // If the lock promise is not yet settled when the modal is closing then it means the modal was canceled,
++      // If the lock promise is not yet resolved when the modal is closing then it means the modal was canceled,
        // i.e. the user doesn't want to force the lock.
        var deferred = modal.data('deferred');
--      if (!deferred.settled) {
++      if (deferred.state() === 'pending') {
          deferred.reject();
        }
      });
@@ -388,19 +388,17 @@
    };
    var load = function(xwikiDocument) {
--    return xwikiDocument.reload().then(xwikiDocument => {
++    return xwikiDocument.reload().done(function(xwikiDocument) {
        // Clone the current document version and keep a reference to it in order to be able to restore it on cancel.
        xwikiDocument.originalDocument = $.extend(true, {
          renderedTitle: $('#document-title h1').html(),
          renderedContent: $('#xwikicontent').html()
        }, xwikiDocument);
--      return xwikiDocument;
--    }).catch(xwikiDocument => {
++    }).fail(function() {
        new XWiki.widgets.Notification(l10n['edit.inplace.page.loadFailed'], 'error');
--      return Promise.reject(xwikiDocument);
      // Render the document for edit, in order to have the annotated content HTML. The annotations are used to protect
      // the rendering transformations (e.g. macros) when editing the content.
--    }).then(render.bind(null, false));
++    }).then($.proxy(render, null, false));
    };
    /**
@@ -413,7 +413,7 @@
    };
    var maybeSave = function(xwikiDocument) {
--    return waitForAction(xwikiDocument).then(action => {
++    return waitForAction(xwikiDocument).then(function(action) {
        switch(action.name) {
          case 'save': return save({
            document: action.document,
@@ -426,29 +426,29 @@
    };
    var waitForAction = function(xwikiDocument) {
--    return new Promise((resolve, reject) => {
--      // We wait for the first save, reload or cancel event, whichever is triggered first. Note that the event listeners
--      // that are not executed first will remain registered but that doesn't cause any problems because the state of a
--      // deferred object (promise) cannot change once it was resolved. So the first event that fires will resolve the
--      // promise and the remaining events won't be able to change that. The remaining event listeners could be called
--      // later but they won't have any effect on the deferred object.
--      $(document).one([
--        'xwiki:actions:save',
--        'xwiki:actions:reload',
--        'xwiki:actions:cancel',
--      ].join(' '), '.xcontent.form', function(event, data) {
--        resolve({
--          name: event.type.substring('xwiki:actions:'.length),
--          document: xwikiDocument,
--          data: data
--        });
++    var deferred = $.Deferred();
++    // We wait for the first save, reload or cancel event, whichever is triggered first. Note that the event listeners
++    // that are not executed first will remain registered but that doesn't cause any problems because the state of a
++    // deferred object (promise) cannot change once it was resolved. So the first event that fires will resolve the
++    // promise and the remaining events won't be able to change that. The remaining event listeners could be called
++    // later but they won't have any effect on the deferred object.
++    $(document).one([
++      'xwiki:actions:save',
++      'xwiki:actions:reload',
++      'xwiki:actions:cancel',
++    ].join(' '), '.xcontent.form', function(event, data) {
++      deferred.resolve({
++        name: event.type.substring('xwiki:actions:'.length),
++        document: xwikiDocument,
++        data: data
        });
      });
++    return deferred.promise();
    };
    var save = function(data) {
      // Push the changes to the server.
--    return push(data.document).then(xwikiDocument => {
++    return push(data.document).then(function(xwikiDocument) {
        // Save succeeded.
        return shouldReload(xwikiDocument).then(
          // The document was saved with merge and thus if we want to continue eding we need to reload the editor (because
@@ -455,7 +455,7 @@
          // its content doesn't match the saved content).
          reload,
          // No need to reload the editor because either the action was Save & View or there was no merge on save.
--        maybeContinueEditing.bind(null, data['continue'])
++        $.proxy(maybeContinueEditing, null, data['continue'])
        );
      // Save failed. Continue editing because we may have unsaved content.
      }, maybeSave);
@@ -463,15 +463,15 @@
    var push = function(xwikiDocument) {
      // Let actionButtons.js do the push. We just catch the result.
--    return new Promise((resolve, reject) => {
--      // We wait for the save request to either succeed or fail. Note that one of the event listeners will remain
--      // registered but that doesn't cause any problems because the state of a deferred object (promise) cannot change
--      // once it was resolved or rejected. So the first event that fires will resolve/reject the promise and the
--      // remaining event won't be able to change that. The remaining event listener could be called later but it won't
--      // have any effect.
--      $(document).one('xwiki:document:saved', '.xcontent.form', resolve.bind(null, xwikiDocument));
--      $(document).one('xwiki:document:saveFailed', '.xcontent.form', reject.bind(null, xwikiDocument));
--    });
++    var deferred = $.Deferred();
++    // We wait for the save request to either succeed or fail. Note that one of the event listeners will remain
++    // registered but that doesn't cause any problems because the state of a deferred object (promise) cannot change
++    // once it was resolved or rejected. So the first event that fires will resolve/reject the promise and the remaining
++    // event won't be able to change that. The remaining event listener could be called later but it won't have any
++    // effect.
++    $(document).one('xwiki:document:saved', '.xcontent.form', $.proxy(deferred, 'resolve', xwikiDocument));
++    $(document).one('xwiki:document:saveFailed', '.xcontent.form', $.proxy(deferred, 'reject', xwikiDocument));
++    return deferred.promise();
    };
    var maybeContinueEditing = function(continueEditing, xwikiDocument) {
@@ -492,9 +492,9 @@
      // Reload the document JSON data (to have the new version) and render the document for view. We need the view HTML
      // both if we stop editing now and if we continue but cancel the edit later.
--    return xwikiDocument.reload().then(render.bind(null, true)).then(
--      afterReloadAndRender.bind(null, /* success: */ true),
--      afterReloadAndRender.bind(null, /* success: */ false)
++    return xwikiDocument.reload().then($.proxy(render, null, true)).then(
++      $.proxy(afterReloadAndRender, null, /* success: */ true),
++      $.proxy(afterReloadAndRender, null, /* success: */ false)
      );
    };
@@ -513,7 +513,7 @@
    };
    // Make sure we unlock the document when the user navigates to another page.
--  $(window).on('unload pagehide', unlock.bind(null, currentXWikiDocument));
++  $(window).on('unload pagehide', $.proxy(unlock, null, currentXWikiDocument));
    var shouldReload = function(xwikiDocument) {
      var reloadEventFired = false;
@@ -520,18 +520,18 @@
      $(document).one('xwiki:actions:reload.maybe', '.xcontent.form', function() {
        reloadEventFired = true;
      });
--    return new Promise((resolve, reject) => {
--      // Wait a bit to see if the reload event is fired.
--      setTimeout(function() {
--        // Remove the listener in case the reload event wasn't fired.
--        $(document).off('xwiki:actions:reload.maybe');
--        if (reloadEventFired) {
--          resolve(xwikiDocument);
--        } else {
--          reject(xwikiDocument);
--        }
--      }, 0);
--    });
++    var deferred = $.Deferred();
++    // Wait a bit to see if the reload event is fired.
++    setTimeout(function() {
++      // Remove the listener in case the reload event wasn't fired.
++      $(document).off('xwiki:actions:reload.maybe');
++      if (reloadEventFired) {
++        deferred.resolve(xwikiDocument);
++      } else {
++        deferred.reject(xwikiDocument);
++      }
++    }, 0);
++    return deferred.promise();
    };
    var reload = function(xwikiDocument) {
@@ -558,7 +558,7 @@
      if (window.location.hash === '#edit' || window.location.hash === '#translate') {
        history.replaceState(null, null, '#');
      }
--    return Promise.resolve(xwikiDocument);
++    return $.Deferred().resolve(xwikiDocument).promise();
    };
    var edit = function(xwikiDocument) {
@@ -603,7 +603,7 @@
          // action buttons so we need to re-enable them each time we enter the edit mode.
          fakeForm.enable();
        }
--      return Promise.resolve(xwikiDocument);
++      return $.Deferred().resolve(xwikiDocument).promise();
      }
    };
@@ -664,9 +664,9 @@
            .parent().removeClass('hidden');
        }
      });
--    return Promise.resolve($.get(XWiki.currentDocument.getURL('get'), {
++    return $.get(XWiki.currentDocument.getURL('get'), {
        xpage: 'editactions'
--    })).then(html => {
++    }).then(function(html) {
        actionButtons.html(html);
        // Fix the name of the Save & View action.
        actionButtons.find('.btn-primary').first().attr('name', 'action_save');
@@ -676,21 +676,21 @@
        actionButtons.append('<div class="hidden extra"/>');
        // Let the others know that the DOM has been updated, in order to enhance it.
        $(document).trigger('xwiki:dom:updated', {'elements': actionButtons.toArray()});
--      return new Promise((resolve, reject) => {
--        require(['xwiki-actionButtons', 'xwiki-diff', 'xwiki-autoSave'], function() {
--          overrideEditActions();
--          overrideAjaxSaveAndContinue();
--          // Activate the auto-save feature passing our fake edit form. Note that autosave.js also creates an instance of
--          // AutoSave but it doesn't do anything because it doesn't find a real edit form in the page. This is why we have
--          // to create our own instance of AutoSave passing the right (fake) form.
--          new XWiki.editors.AutoSave({form: fakeForm});
--          var xwikiDocument = actionButtons.data('xwikiDocument');
--          // Enable the action buttons (and their shortcut keys) only if we're editing a document.
--          actionButtons.find(':input').prop('disabled', !xwikiDocument);
--          resolve(xwikiDocument);
--        });
++      var deferred = $.Deferred();
++      require(['xwiki-actionButtons', 'xwiki-diff', 'xwiki-autoSave'], function() {
++        overrideEditActions();
++        overrideAjaxSaveAndContinue();
++        // Activate the auto-save feature passing our fake edit form. Note that autosave.js also creates an instance of
++        // AutoSave but it doesn't do anything because it doesn't find a real edit form in the page. This is why we have
++        // to create our own instance of AutoSave passing the right (fake) form.
++        new XWiki.editors.AutoSave({form: fakeForm});
++        var xwikiDocument = actionButtons.data('xwikiDocument');
++        // Enable the action buttons (and their shortcut keys) only if we're editing a document.
++        actionButtons.find(':input').prop('disabled', !xwikiDocument);
++        deferred.resolve(xwikiDocument);
        });
--    }).catch(() => {
++      return deferred.promise();
++    }, function() {
        new XWiki.widgets.Notification(l10n['edit.inplace.actionButtons.loadFailed'], 'error');
      });
    };
@@ -731,13 +731,6 @@
          extra[entry.name] = value;
          return extra;
        }, {});
--      // retrieve all input fields listing the temporary uploaded files.
--      var uploadedFiles = $('#xwikicontent').nextAll('input[name="uploadedFiles"]').serializeArray().reduce(function(extra, entry) {
--        var value = extra[entry.name] || [];
--        value.push(entry.value);
--        extra[entry.name] = value;
--        return extra;
--      }, {});
        var xwikiDocument = this._getActionButtons().data('xwikiDocument');
        var formData = {
          title: xwikiDocument.rawTitle,
@@ -755,8 +755,6 @@
            content_syntax: xwikiDocument.syntax
          });
        }
--      // Add the temporary uploaded files to the form.
--      $.extend(formData, uploadedFiles);
        // Check for merge conflicts only if the document is not new and we know the current version.
        if (!xwikiDocument.isNew && xwikiDocument.version) {
          formData.previousVersion = xwikiDocument.version;
@@ -845,7 +845,7 @@
        deferred: $.Deferred()
      });
      editContent.trigger('xwiki:actions:edit', data);
--    return data.deferred.promise().then(() => {
++    return data.deferred.done(function() {
        editContent.show();
        viewContent.remove();
        if (withFocus) {
@@ -856,8 +856,7 @@
            editContent[0].focus({preventScroll: true});
          }, 0);
        }
--      return xwikiDocument;
--    });
++    }).promise();
    };
    var startRealTimeEditingSession = function(xwikiDocument) {
@@ -922,7 +922,7 @@
      require(['editInPlace', wysiwygEditorModule], function(editInPlace) {
        // Re-enable the translate button because it can be used while editing to create the missing translation.
        translateButton.removeClass('disabled');
--      handler.edit(editInPlace, data).finally(function() {
++      handler.edit(editInPlace, data).always(function() {
          // Restore only the edit button at the end because:
          // * the translate button is restored (if needed) by the editInPlace module
          // * the section edit links are restored when the document is rendered for view
@@ -929,7 +929,7 @@
          editButton.removeClass('disabled');
        });
      // Fallback on the standalone edit mode if we fail to load the required modules.
--    }, disableInPlaceEditing.bind(event.target));
++    }, $.proxy(disableInPlaceEditing, event.target));
    };
    var disableInPlaceEditing = function() {

XWiki.UIExtensionClass[0]

Executed Content

@@ -48,6 +48,7 @@
        'editButtonSelector': '#tmEdit > a',
        'translateButtonSelector': '#tmTranslate > a',
        'enableSourceMode': true,
++      'enableOfficeImport': $services.officemanager.isConnected(),
        'paths': {
          'js': {
            'xwiki-actionButtons': "#getSkinFileWithParams('js/xwiki/actionbuttons/actionButtons.js' $jsParams)",