Class: CharacterData

@nginstack/engine/lib/dom/CharacterData~ CharacterData

new CharacterData()

A classe abstrata CharacterData é uma interface que representa um nó que contém caracteres.

Esta é uma interface abstrata, significando que não há objetos do tipo CharacterData: ela é implementada por outras classes, como Text, Comment, ou ProcessingInstruction as quais não são abstratas.

A classe CharacterData herda as propriedades e métodos de module:@nginstack/engine/lib/dom/Node~Node.

Documentação adaptada de CharacterData dos Mozilla Contributors e licenciada sob CC-BY-SA 2.5.

Extends

Members

<readonly> childNodes :module:@nginstack/engine/lib/dom/NodeList~NodeList

Retorna um objeto NodeList "vivo" contendo todos os filhos deste nó. Dizer que um objeto NodeList é vivo significa que se houver alguma mudança em um dos filhos deste nó, o objeto NodeList é automaticamente atualizado com tais mudanças.

Type:
Inherited From:

data :string

É uma DOMString representando o dado textual contido neste objeto.

Type:
  • string

<readonly> firstChild :module:@nginstack/engine/lib/dom/Node~Node

Retorna um Node representando o primeiro filho direto do nó ou null, caso o nó não tenha nenhum filho.

Type:
Inherited From:

<readonly> lastChild :module:@nginstack/engine/lib/dom/Node~Node

Retorna um Node representando o último filho direto do elemento ou null, caso o elemento não tenha nenhum filho.

Type:
Inherited From:

<readonly> length :number

Retorna um número inteiro representando o tamanho da string contida em #data.

Type:
  • number

<readonly> namespaceURI :string

O espaço de nomes URI desse nó, ou null se não estiver no espaço de nomes.

Type:
  • string
Inherited From:
Deprecated:
  • Yes

<readonly> nextSibling :module:@nginstack/engine/lib/dom/Node~Node

Retorna um Node representando o próximo nó em uma árvore ou null se não existe tal nodo.

Type:
Inherited From:

<readonly> nodeName :string

Retorna uma DOMString contendo o nome do elemento, do Node. A estrutura do nome irá mudar conforme o tipo do elemento. Veja as diferenças na documentação do método Node.nodeName.

Type:
  • string
Inherited From:

<readonly> nodeType :NodeType|''

Retorna um número inteiro representando o tipo do nó. Os valores possíveis são:

  • ELEMENT_NODE: 1
  • ATTRIBUTE_NODE: 2
  • TEXT_NODE: 3
  • CDATA_SECTION_NODE: 4
  • ENTITY_REFERENCE_NODE: 5
  • ENTITY_NODE: 6
  • PROCESSING_INSTRUCTION_NODE: 7
  • COMMENT_NODE: 8
  • DOCUMENT_NODE: 9
  • DOCUMENT_TYPE_NODE: 10
  • DOCUMENT_FRAGMENT_NODE: 11
  • NOTATION_NODE: 12
Type:
  • NodeType| ''
Inherited From:

<readonly> nodeValue :string

Retorna ou define o valor do nó atual.

Type:
  • string
Inherited From:

<readonly> ownerDocument :module:@nginstack/engine/lib/dom/Document~Document

Retorna o Document qual esse nó pertence. Se o nó em si é um documento, retorna null.

Type:
Inherited From:

<readonly> parentNode :module:@nginstack/engine/lib/dom/Node~Node

Retorna um Node que é pai desse nó. Se não existe tal nó, como, por exemplo, se esse nó é o topo da árvore ou se ele não participa de uma árvore, essa propriedade retorna null.

Type:
Inherited From:

<readonly> prefix :string

É um DOMString representando o espaço de nomes do nó, ou null se nenhum prefixo é especificado.

Type:
  • string
Inherited From:

<readonly> previousSibling :module:@nginstack/engine/lib/dom/Node~Node

Retorna um Node representando o nó anterior em uma árvore ou null se não existe tal nodo.

Type:
Inherited From:

Methods

appendChild(newChild)

Adiciona um nó ao final da lista de filhos de um nó pai especificado.

Se filho é uma referência a um nó existente no documento, appendChild vai movê-lo de sua posição atual para a nova posição (i.e, não é necessário remover o nó de seu pai atual antes de adicioná-lo a outro nó).

Isso também significa que um nó não pode estar em dois lugares do documento ao mesmo tempo. Assim, se o nó já tem um pai, ele é primeiro removido para, só então, ser adicionado na nova posição.

Você pode usar o método #cloneNode para criar uma cópia do nó antes de adicioná-lo ao novo pai. Note que cópias feitas com o método cloneNode não serão mantidas sincronizadas automaticamente.

Parameters:
Name Type Description
newChild module:@nginstack/engine/lib/dom/Node~Node

É o nó a ser adicionado como filho de elemento.
Inherited From:
Returns:

Nó adicionado no DOM, o mesmo que foi informado em newChild.

Type
module:@nginstack/engine/lib/dom/Node~Node

appendData(data)

Adiciona a string informada no final de #data.

Parameters:
Name Type Description
data string

String a ser adicionada ao final de #data.

cloneNode(deep)

Duplica um elemento node (nó) da estrutura de um documento DOM. Ele retorna um clone do elemento para o qual foi invocado.

Parameters:
Name Type Description
deep boolean

Indica se os elementos filhos do nó que está sendo clonado devem ser clonados juntos. Informe false para clonar apenas o nó específico dispensando, assim, qualquer elemento DOM filho.
Inherited From:
Returns:

O novo elemento node (nó) resultado da clonagem.

Type
module:@nginstack/engine/lib/dom/Node~Node

deleteData(offset, count)

Remove a quantidade especificada de caracteres, iniciando no offset informado, da string #data.

Parameters:
Name Type Description
offset number

Posição que define o início da seção a ser removida.
count number

Quantidade de caracteres a partir de offset que serão removidos.

hasChildNodes()

Este método retorna um valor booleano indicando se o nó corrente tem filhos ou não.

Inherited From:
Returns:

True se o nó tiver filhos.

Type
boolean

insertBefore(newChild, refChild)

Adiciona o nó especificado, antes de um elemento de referência, como filho do nó atual.

Parameters:
Name Type Description
newChild module:@nginstack/engine/lib/dom/Node~Node

O nó a ser inserido.
refChild module:@nginstack/engine/lib/dom/Node~Node

O nó antes do qual o newChild será inserido.
Inherited From:
Returns:

O nó sendo inserido, que é newChild.

Type
module:@nginstack/engine/lib/dom/Node~Node

insertData(offset, data)

Insere o texto informado na posição indicada por offset em #data.

Parameters:
Name Type Description
offset number

Posição onde data será inserido.
data string

String a ser adicionada na posição offset.

normalize()

Coloca o nó e todos os nós filhos nas suas formas normalizadas. Em uma subárvore normalizada não há nós do tipo Text vazios, nem há nós adjacentes desse mesmo tipo.

Inherited From:

removeChild(oldChild)

Remove um nó filho do DOM. Devolve o nó removido.

Parameters:
Name Type Description
oldChild module:@nginstack/engine/lib/dom/Node~Node

É o nó filho a ser removido do DOM.
Inherited From:
Returns:

Contém uma referência ao nó filho removido.

Type
module:@nginstack/engine/lib/dom/Node~Node

replaceChild(newChild, oldChild)

Substitui o elemento filho especificado por outro.

Parameters:
Name Type Description
newChild module:@nginstack/engine/lib/dom/Node~Node

É o novo elemento que será inserido no lugar do oldChild. Se já existir no DOM, será removido primeiro para depois ser inserido.
oldChild module:@nginstack/engine/lib/dom/Node~Node

É o elemento existente que será substituído.
Inherited From:
Returns:

É o elemento substituído. É o mesmo elemento que oldChild.

Type
module:@nginstack/engine/lib/dom/Node~Node

replaceData(offset, count, data)

Substitui a quantidade de caracteres, iniciando a partir do offset informado, pela string informada.

Parameters:
Name Type Description
offset number

Posição que define o início da seção a ser removida.
count number

Quantidade de caracteres a partir de offset que serão removidos.
data string

Texto que será inserido no lugar da seção removida.

substringData(offset, count)

Retorna uma DOMString contendo a parte de #data com o tamanho especificado e iniciando no offset informado.

Parameters:
Name Type Description
offset number

Posição inicial da qual será extraída uma substring.
count number

Quantidade de caracteres que serão lidos a partir de offset.
Returns:

Substring da posição e tamanho informados.

Type
string