Class: Text

@nginstack/engine/lib/dom/Text~ Text


new Text()

A classe Text representa um conteúdo texto de um Element ou Attr.

Se um elemento não tem markup dentro do seu conteúdo, ele terá um único filho Text que conterá o texto do contido no elemento. No entanto, se o elemento contiver markup, esse conteúdo será estruturado em itens esses markups e nós do tipo Text que formam seus filhos.

Novos documentos tem um nó simples do tipo Text para cada bloco de texto. Com o tempo, mais nós do tipo Text podem ser criados na medida que o documento é alterado. O método module:@nginstack/engine/lib/dom/Node~Node#normalize pode ser utilizado para mesclar os textos adjacentes em um nó único do tipo Text.

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

Documentação adaptada de Text 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
Inherited From:

<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
Inherited From:

<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.

Inherited From:

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.

Inherited From:

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.

Inherited From:

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.

Inherited From:

splitText(offset)

Quebra o nó do tipo Text em dois nós a partir do offset informado, mantendo ambos os nós na árvore como vizinhos.

Depois da quebra, o nó corrente contém todo o conteúdo até o ponto especificado pelo offset, um novo nó criado do mesmo tipo contendo o texto remanescente. O nó criado é retornado como resultado.

Se o nó original tiver um parent definido, o novo nó é inserido como o próximo vizinho do nó original. Se o offset for igual ao tamanho do nó original, o novo nó não terá dados.

Nós textuais separados podem ser concatenados posteriormente utilizando o método module:@nginstack/engine/lib/dom/Node~Node#normalize.

Parameters:
Name Type Description
offset number

Posição que definição o ponto de quebra do nó corrente.

Returns:

Nó criado a partir da quebra.

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

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.

Inherited From:
Returns:

Substring da posição e tamanho informados.

Type
string