Blame editor/libeditor/EditorUtils.cpp

Packit f0b94e
/* -*- Mode: C++; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
Packit f0b94e
/* This Source Code Form is subject to the terms of the Mozilla Public
Packit f0b94e
 * License, v. 2.0. If a copy of the MPL was not distributed with this
Packit f0b94e
 * file, You can obtain one at http://mozilla.org/MPL/2.0/. */
Packit f0b94e
Packit f0b94e
#include "mozilla/EditorUtils.h"
Packit f0b94e
Packit f0b94e
#include "mozilla/EditorDOMPoint.h"
Packit f0b94e
#include "mozilla/OwningNonNull.h"
Packit f0b94e
#include "mozilla/dom/Selection.h"
Packit f0b94e
#include "nsComponentManagerUtils.h"
Packit f0b94e
#include "nsError.h"
Packit f0b94e
#include "nsIClipboardDragDropHookList.h"
Packit f0b94e
// hooks
Packit f0b94e
#include "nsIClipboardDragDropHooks.h"
Packit f0b94e
#include "nsIContent.h"
Packit f0b94e
#include "nsIContentIterator.h"
Packit f0b94e
#include "nsIDOMDocument.h"
Packit f0b94e
#include "nsIDocShell.h"
Packit f0b94e
#include "nsIDocument.h"
Packit f0b94e
#include "nsIInterfaceRequestorUtils.h"
Packit f0b94e
#include "nsINode.h"
Packit f0b94e
#include "nsISimpleEnumerator.h"
Packit f0b94e
Packit f0b94e
class nsISupports;
Packit f0b94e
class nsRange;
Packit f0b94e
Packit f0b94e
namespace mozilla {
Packit f0b94e
Packit f0b94e
using namespace dom;
Packit f0b94e
Packit f0b94e
/******************************************************************************
Packit f0b94e
 * AutoSelectionRestorer
Packit f0b94e
 *****************************************************************************/
Packit f0b94e
Packit f0b94e
AutoSelectionRestorer::AutoSelectionRestorer(
Packit f0b94e
    Selection* aSelection,
Packit f0b94e
    EditorBase* aEditorBase MOZ_GUARD_OBJECT_NOTIFIER_PARAM_IN_IMPL)
Packit f0b94e
    : mEditorBase(nullptr) {
Packit f0b94e
  MOZ_GUARD_OBJECT_NOTIFIER_INIT;
Packit f0b94e
  if (NS_WARN_IF(!aSelection) || NS_WARN_IF(!aEditorBase)) {
Packit f0b94e
    return;
Packit f0b94e
  }
Packit f0b94e
  if (aEditorBase->ArePreservingSelection()) {
Packit f0b94e
    // We already have initialized mSavedSel, so this must be nested call.
Packit f0b94e
    return;
Packit f0b94e
  }
Packit f0b94e
  mSelection = aSelection;
Packit f0b94e
  mEditorBase = aEditorBase;
Packit f0b94e
  mEditorBase->PreserveSelectionAcrossActions(mSelection);
Packit f0b94e
}
Packit f0b94e
Packit f0b94e
AutoSelectionRestorer::~AutoSelectionRestorer() {
Packit f0b94e
  NS_ASSERTION(!mSelection || mEditorBase,
Packit f0b94e
               "mEditorBase should be non-null when mSelection is");
Packit f0b94e
  // mSelection will be null if this was nested call.
Packit f0b94e
  if (mSelection && mEditorBase->ArePreservingSelection()) {
Packit f0b94e
    mEditorBase->RestorePreservedSelection(mSelection);
Packit f0b94e
  }
Packit f0b94e
}
Packit f0b94e
Packit f0b94e
void AutoSelectionRestorer::Abort() {
Packit f0b94e
  NS_ASSERTION(!mSelection || mEditorBase,
Packit f0b94e
               "mEditorBase should be non-null when mSelection is");
Packit f0b94e
  if (mSelection) {
Packit f0b94e
    mEditorBase->StopPreservingSelection();
Packit f0b94e
  }
Packit f0b94e
}
Packit f0b94e
Packit f0b94e
/******************************************************************************
Packit f0b94e
 * some helper classes for iterating the dom tree
Packit f0b94e
 *****************************************************************************/
Packit f0b94e
Packit f0b94e
DOMIterator::DOMIterator(
Packit f0b94e
    nsINode& aNode MOZ_GUARD_OBJECT_NOTIFIER_PARAM_IN_IMPL) {
Packit f0b94e
  MOZ_GUARD_OBJECT_NOTIFIER_INIT;
Packit f0b94e
  mIter = NS_NewContentIterator();
Packit f0b94e
  DebugOnly<nsresult> rv = mIter->Init(&aNode);
Packit f0b94e
  MOZ_ASSERT(NS_SUCCEEDED(rv));
Packit f0b94e
}
Packit f0b94e
Packit f0b94e
nsresult DOMIterator::Init(nsRange& aRange) {
Packit f0b94e
  mIter = NS_NewContentIterator();
Packit f0b94e
  return mIter->Init(&aRange);
Packit f0b94e
}
Packit f0b94e
Packit f0b94e
DOMIterator::DOMIterator(MOZ_GUARD_OBJECT_NOTIFIER_ONLY_PARAM_IN_IMPL) {
Packit f0b94e
  MOZ_GUARD_OBJECT_NOTIFIER_INIT;
Packit f0b94e
}
Packit f0b94e
Packit f0b94e
DOMIterator::~DOMIterator() {}
Packit f0b94e
Packit f0b94e
void DOMIterator::AppendList(
Packit f0b94e
    const BoolDomIterFunctor& functor,
Packit f0b94e
    nsTArray<OwningNonNull<nsINode>>& arrayOfNodes) const {
Packit f0b94e
  // Iterate through dom and build list
Packit f0b94e
  for (; !mIter->IsDone(); mIter->Next()) {
Packit f0b94e
    nsCOMPtr<nsINode> node = mIter->GetCurrentNode();
Packit f0b94e
Packit f0b94e
    if (functor(node)) {
Packit f0b94e
      arrayOfNodes.AppendElement(*node);
Packit f0b94e
    }
Packit f0b94e
  }
Packit f0b94e
}
Packit f0b94e
Packit f0b94e
DOMSubtreeIterator::DOMSubtreeIterator(
Packit f0b94e
    MOZ_GUARD_OBJECT_NOTIFIER_ONLY_PARAM_IN_IMPL)
Packit f0b94e
    : DOMIterator(MOZ_GUARD_OBJECT_NOTIFIER_ONLY_PARAM_TO_PARENT) {}
Packit f0b94e
Packit f0b94e
nsresult DOMSubtreeIterator::Init(nsRange& aRange) {
Packit f0b94e
  mIter = NS_NewContentSubtreeIterator();
Packit f0b94e
  return mIter->Init(&aRange);
Packit f0b94e
}
Packit f0b94e
Packit f0b94e
DOMSubtreeIterator::~DOMSubtreeIterator() {}
Packit f0b94e
Packit f0b94e
/******************************************************************************
Packit f0b94e
 * some general purpose editor utils
Packit f0b94e
 *****************************************************************************/
Packit f0b94e
Packit f0b94e
bool EditorUtils::IsDescendantOf(const nsINode& aNode, const nsINode& aParent,
Packit f0b94e
                                 EditorRawDOMPoint* aOutPoint /* = nullptr */) {
Packit f0b94e
  if (aOutPoint) {
Packit f0b94e
    aOutPoint->Clear();
Packit f0b94e
  }
Packit f0b94e
Packit f0b94e
  if (&aNode == &aParent) {
Packit f0b94e
    return false;
Packit f0b94e
  }
Packit f0b94e
Packit f0b94e
  for (const nsINode* node = &aNode; node; node = node->GetParentNode()) {
Packit f0b94e
    if (node->GetParentNode() == &aParent) {
Packit f0b94e
      if (aOutPoint) {
Packit f0b94e
        MOZ_ASSERT(node->IsContent());
Packit f0b94e
        aOutPoint->Set(node->AsContent());
Packit f0b94e
      }
Packit f0b94e
      return true;
Packit f0b94e
    }
Packit f0b94e
  }
Packit f0b94e
Packit f0b94e
  return false;
Packit f0b94e
}
Packit f0b94e
Packit f0b94e
bool EditorUtils::IsDescendantOf(const nsINode& aNode, const nsINode& aParent,
Packit f0b94e
                                 EditorDOMPoint* aOutPoint) {
Packit f0b94e
  MOZ_ASSERT(aOutPoint);
Packit f0b94e
  aOutPoint->Clear();
Packit f0b94e
  if (&aNode == &aParent) {
Packit f0b94e
    return false;
Packit f0b94e
  }
Packit f0b94e
Packit f0b94e
  for (const nsINode* node = &aNode; node; node = node->GetParentNode()) {
Packit f0b94e
    if (node->GetParentNode() == &aParent) {
Packit f0b94e
      MOZ_ASSERT(node->IsContent());
Packit f0b94e
      aOutPoint->Set(node->AsContent());
Packit f0b94e
      return true;
Packit f0b94e
    }
Packit f0b94e
  }
Packit f0b94e
Packit f0b94e
  return false;
Packit f0b94e
}
Packit f0b94e
Packit f0b94e
/******************************************************************************
Packit f0b94e
 * utility methods for drag/drop/copy/paste hooks
Packit f0b94e
 *****************************************************************************/
Packit f0b94e
Packit f0b94e
nsresult EditorHookUtils::GetHookEnumeratorFromDocument(
Packit f0b94e
    nsIDOMDocument* aDoc, nsISimpleEnumerator** aResult) {
Packit f0b94e
  nsCOMPtr<nsIDocument> doc = do_QueryInterface(aDoc);
Packit f0b94e
  NS_ENSURE_TRUE(doc, NS_ERROR_FAILURE);
Packit f0b94e
Packit f0b94e
  nsCOMPtr<nsIDocShell> docShell = doc->GetDocShell();
Packit f0b94e
  nsCOMPtr<nsIClipboardDragDropHookList> hookObj = do_GetInterface(docShell);
Packit f0b94e
  NS_ENSURE_TRUE(hookObj, NS_ERROR_FAILURE);
Packit f0b94e
Packit f0b94e
  return hookObj->GetHookEnumerator(aResult);
Packit f0b94e
}
Packit f0b94e
Packit f0b94e
bool EditorHookUtils::DoInsertionHook(nsIDOMDocument* aDoc,
Packit f0b94e
                                      nsIDOMEvent* aDropEvent,
Packit f0b94e
                                      nsITransferable* aTrans) {
Packit f0b94e
  nsCOMPtr<nsISimpleEnumerator> enumerator;
Packit f0b94e
  GetHookEnumeratorFromDocument(aDoc, getter_AddRefs(enumerator));
Packit f0b94e
  NS_ENSURE_TRUE(enumerator, true);
Packit f0b94e
Packit f0b94e
  bool hasMoreHooks = false;
Packit f0b94e
  while (NS_SUCCEEDED(enumerator->HasMoreElements(&hasMoreHooks)) &&
Packit f0b94e
         hasMoreHooks) {
Packit f0b94e
    nsCOMPtr<nsISupports> isupp;
Packit f0b94e
    if (NS_FAILED(enumerator->GetNext(getter_AddRefs(isupp)))) {
Packit f0b94e
      break;
Packit f0b94e
    }
Packit f0b94e
Packit f0b94e
    nsCOMPtr<nsIClipboardDragDropHooks> override = do_QueryInterface(isupp);
Packit f0b94e
    if (override) {
Packit f0b94e
      bool doInsert = true;
Packit f0b94e
      DebugOnly<nsresult> hookResult =
Packit f0b94e
          override->OnPasteOrDrop(aDropEvent, aTrans, &doInsert);
Packit f0b94e
      NS_ASSERTION(NS_SUCCEEDED(hookResult), "hook failure in OnPasteOrDrop");
Packit f0b94e
      NS_ENSURE_TRUE(doInsert, false);
Packit f0b94e
    }
Packit f0b94e
  }
Packit f0b94e
Packit f0b94e
  return true;
Packit f0b94e
}
Packit f0b94e
Packit f0b94e
}  // namespace mozilla