gecko-dev/editor/nsIEditActionListener.idl

/* -*- Mode: C++; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
/* This Source Code Form is subject to the terms of the Mozilla Public
 * License, v. 2.0. If a copy of the MPL was not distributed with this
 * file, You can obtain one at http://mozilla.org/MPL/2.0/. */

#include "nsISupports.idl"
#include "domstubs.idl"

webidl CharacterData;
webidl Node;
webidl Range;

%{C++
#include "mozilla/EditorDOMPoint.h"
class nsINode;
class nsIContent;
namespace mozilla {
template class EditorDOMPointBase<nsINode*, nsIContent*>;
} // namespace mozilla
%}

[ref] native EditorRawDOMPointRef(mozilla::EditorDOMPointBase<nsINode*, nsIContent*>);

/*
Editor Action Listener interface to outside world
*/


/**
 * A generic editor action listener interface.
 * <P>
 * nsIEditActionListener is the interface used by applications wishing to be notified
 * when the editor modifies the DOM tree.
 *
 * Note:  this is the wrong class to implement if you are interested in generic
 * change notifications.  For generic notifications, you should implement
 * nsIDocumentObserver.
 */
[scriptable, uuid(b22907b1-ee93-11d2-8d50-000064657374)]
interface nsIEditActionListener : nsISupports
{
  /**
   * Called after the editor deletes a node.
   * @param aChild    The node to delete
   * @param aResult   The result of the delete node operation.
   */
  void DidDeleteNode(in Node aChild, in nsresult aResult);

  /**
   * Called after the editor joins 2 nodes.
   * @param aJoinedPoint   The joined point.  If aLeftNodeWasRemoved is true,
   *                       it points after inserted left node content in the
   *                       right node.  Otherwise, it points start of inserted
   *                       right node content in the left node.
   * @param aRemovedNode   The removed node.
   * @param aLeftNodeWasRemoved
   *                       true if left node is removed and its contents were
   *                       moved into start of the right node.
   *                       false if right node is removed and its contents were
   *                       moved into end of the left node.
   */
  [noscript]
  void DidJoinContents([const] in EditorRawDOMPointRef aJoinedPoint,
                       [const] in Node aRemovedNode,
                       in bool aLeftNodeWasRemoved);

  /**
   * Called after the editor inserts text.
   * @param aTextNode   This node getting inserted text.
   * @param aOffset     The offset in aTextNode to insert at.
   * @param aString     The string that gets inserted.
   * @param aResult     The result of the insert text operation.
   */
  void DidInsertText(in CharacterData       aTextNode,
                     in long                aOffset,
                     in AString             aString,
                     in nsresult            aResult);

  /**
   * Called before the editor deletes text.
   * @param aTextNode   This node getting text deleted.
   * @param aOffset     The offset in aTextNode to delete at.
   * @param aLength     The amount of text to delete.
   */
  void WillDeleteText(in CharacterData       aTextNode,
                      in long                aOffset,
                      in long                aLength);

  /**
   * Called before the editor deletes the ranges.
   * @param aRangesToDelete     The ranges to be deleted.
   */
  void WillDeleteRanges(in Array<Range> aRangesToDelete);
};