Class: ProcessingInstruction

@nginstack/engine/lib/dom/ProcessingInstruction~ ProcessingInstruction


new ProcessingInstruction()

Uma ProcessingInstruction (Instrução de Processamento) incorpora instruções específicas de aplicações em XML que pode ser ignorada por outras aplicações que não as reconhece. Mesmo se um processador XML ignora as instruções de processamento, irá dá-los um lugar no DOM.

Uma instrução de processamento é diferente de uma declaração XML, que fornece informação sobre o documento como por exemplo codificação de caracteres, e pode somente aparecer como o primeiro item em um documento.

Instruções de processamento definidas por usuário não podem começar com 'xml', pois estes são reservados (como ).

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

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

Deprecated:
  • Esta funcionalidade é obsoleta pela especificação e seu uso é desencorajado, pois poderá ser removida no futuro.

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

Texto iniciado no primeiro caracter que não seja um espaço em branco depois de target de antes de "?>".

Type:
  • string
Overrides:

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

target :string

Texto depois de "<?"" e antes do espaço que o separada de data.

Type:
  • string

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:

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