Source code

Revision control

Copy as Markdown

Other Tools

/* -*- Mode: C++; tab-width: 8; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
/* vim: set ts=8 sts=2 et sw=2 tw=80: */
/* 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 */
* Implementation of DOM Core's Text node.
#include "nsTextNode.h"
#include "mozilla/dom/TextBinding.h"
#include "nsContentUtils.h"
#include "mozilla/dom/DirectionalityUtils.h"
#include "mozilla/dom/Document.h"
#include "nsThreadUtils.h"
#include "nsStubMutationObserver.h"
#include "mozilla/IntegerPrintfMacros.h"
# include "nsRange.h"
using namespace mozilla;
using namespace mozilla::dom;
* class used to implement attr() generated content
class nsAttributeTextNode final : public nsTextNode,
public nsStubMutationObserver {
nsAttributeTextNode(already_AddRefed<mozilla::dom::NodeInfo>&& aNodeInfo,
int32_t aNameSpaceID, nsAtom* aAttrName)
: nsTextNode(std::move(aNodeInfo)),
mAttrName(aAttrName) {
NS_ASSERTION(mNameSpaceID != kNameSpaceID_Unknown, "Must know namespace");
NS_ASSERTION(mAttrName, "Must have attr name");
virtual nsresult BindToTree(BindContext&, nsINode& aParent) override;
virtual void UnbindFromTree(bool aNullParent = true) override;
virtual already_AddRefed<CharacterData> CloneDataNode(
mozilla::dom::NodeInfo* aNodeInfo, bool aCloneText) const override {
RefPtr<nsAttributeTextNode> it = new (aNodeInfo->NodeInfoManager())
nsAttributeTextNode(do_AddRef(aNodeInfo), mNameSpaceID, mAttrName);
if (aCloneText) {
it->mText = mText;
return it.forget();
// Public method for the event to run
void UpdateText() { UpdateText(true); }
virtual ~nsAttributeTextNode() {
NS_ASSERTION(!mGrandparent, "We were not unbound!");
// Update our text to our parent's current attr value
void UpdateText(bool aNotify);
// This doesn't need to be a strong pointer because it's only non-null
// while we're bound to the document tree, and it points to an ancestor
// so the ancestor must be bound to the document tree the whole time
// and can't be deleted.
Element* mGrandparent;
// What attribute we're showing
int32_t mNameSpaceID;
RefPtr<nsAtom> mAttrName;
nsTextNode::~nsTextNode() = default;
// Use the CC variant of this, even though this class does not define
// a new CC participant, to make QIing to the CC interfaces faster.
JSObject* nsTextNode::WrapNode(JSContext* aCx,
JS::Handle<JSObject*> aGivenProto) {
return Text_Binding::Wrap(aCx, this, aGivenProto);
already_AddRefed<CharacterData> nsTextNode::CloneDataNode(
mozilla::dom::NodeInfo* aNodeInfo, bool aCloneText) const {
RefPtr<nsTextNode> it =
new (aNodeInfo->NodeInfoManager()) nsTextNode(do_AddRef(aNodeInfo));
if (aCloneText) {
it->mText = mText;
return it.forget();
nsresult nsTextNode::AppendTextForNormalize(const char16_t* aBuffer,
uint32_t aLength, bool aNotify,
nsIContent* aNextSibling) {
CharacterDataChangeInfo::Details details = {
CharacterDataChangeInfo::Details::eMerge, aNextSibling};
return SetTextInternal(mText.GetLength(), 0, aBuffer, aLength, aNotify,
nsresult nsTextNode::BindToTree(BindContext& aContext, nsINode& aParent) {
nsresult rv = CharacterData::BindToTree(aContext, aParent);
return NS_OK;
void nsTextNode::UnbindFromTree(bool aNullParent) {
void nsTextNode::List(FILE* out, int32_t aIndent) const {
int32_t index;
for (index = aIndent; --index >= 0;) fputs(" ", out);
fprintf(out, "Text@%p", static_cast<const void*>(this));
fprintf(out, " flags=[%08x]", static_cast<unsigned int>(GetFlags()));
if (IsClosestCommonInclusiveAncestorForRangeInSelection()) {
const LinkedList<nsRange>* ranges =
int32_t count = 0;
if (ranges) {
// Can't use range-based iteration on a const LinkedList, unfortunately.
for (const nsRange* r = ranges->getFirst(); r; r = r->getNext()) {
fprintf(out, " ranges:%d", count);
fprintf(out, " primaryframe=%p", static_cast<void*>(GetPrimaryFrame()));
fprintf(out, " refcount=%" PRIuPTR "<", mRefCnt.get());
nsAutoString tmp;
ToCString(tmp, 0, mText.GetLength());
fputs(NS_LossyConvertUTF16toASCII(tmp).get(), out);
fputs(">\n", out);
void nsTextNode::DumpContent(FILE* out, int32_t aIndent, bool aDumpAll) const {
if (aDumpAll) {
int32_t index;
for (index = aIndent; --index >= 0;) fputs(" ", out);
nsAutoString tmp;
ToCString(tmp, 0, mText.GetLength());
if (!tmp.EqualsLiteral("\\n")) {
fputs(NS_LossyConvertUTF16toASCII(tmp).get(), out);
if (aIndent) fputs("\n", out);
nsresult NS_NewAttributeContent(nsNodeInfoManager* aNodeInfoManager,
int32_t aNameSpaceID, nsAtom* aAttrName,
nsIContent** aResult) {
MOZ_ASSERT(aNodeInfoManager, "Missing nodeInfoManager");
MOZ_ASSERT(aAttrName, "Must have an attr name");
MOZ_ASSERT(aNameSpaceID != kNameSpaceID_Unknown, "Must know namespace");
*aResult = nullptr;
RefPtr<mozilla::dom::NodeInfo> ni = aNodeInfoManager->GetTextNodeInfo();
RefPtr<nsAttributeTextNode> textNode = new (aNodeInfoManager)
nsAttributeTextNode(ni.forget(), aNameSpaceID, aAttrName);
return NS_OK;
NS_IMPL_ISUPPORTS_INHERITED(nsAttributeTextNode, nsTextNode,
nsresult nsAttributeTextNode::BindToTree(BindContext& aContext,
nsINode& aParent) {
MOZ_ASSERT(aParent.IsContent() && aParent.GetParent(),
"This node can't be a child of the document or of "
"the document root");
nsresult rv = nsTextNode::BindToTree(aContext, aParent);
NS_ASSERTION(!mGrandparent, "We were already bound!");
mGrandparent = aParent.GetParent()->AsElement();
// Note that there is no need to notify here, since we have no
// frame yet at this point.
return NS_OK;
void nsAttributeTextNode::UnbindFromTree(bool aNullParent) {
// UnbindFromTree can be called anytime so we have to be safe.
if (mGrandparent) {
// aNullParent might not be true here, but we want to remove the
// mutation observer anyway since we only need it while we're
// in the document.
mGrandparent = nullptr;
void nsAttributeTextNode::AttributeChanged(Element* aElement,
int32_t aNameSpaceID,
nsAtom* aAttribute, int32_t aModType,
const nsAttrValue* aOldValue) {
if (aNameSpaceID == mNameSpaceID && aAttribute == mAttrName &&
aElement == mGrandparent) {
// Since UpdateText notifies, do it when it's safe to run script. Note
// that if we get unbound while the event is up that's ok -- we'll just
// have no grandparent when it fires, and will do nothing.
void (nsAttributeTextNode::*update)() = &nsAttributeTextNode::UpdateText;
"nsAttributeTextNode::AttributeChanged", this, update));
void nsAttributeTextNode::NodeWillBeDestroyed(nsINode* aNode) {
NS_ASSERTION(aNode == static_cast<nsINode*>(mGrandparent), "Wrong node!");
mGrandparent = nullptr;
void nsAttributeTextNode::UpdateText(bool aNotify) {
if (mGrandparent) {
nsAutoString attrValue;
mGrandparent->GetAttr(mNameSpaceID, mAttrName, attrValue);
SetText(attrValue, aNotify);