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
-
<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:
-
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 newChildmodule:@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.
-
appendData(data)
-
Adiciona a string informada no final de #data.
Parameters:
Name Type Description datastring 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 deepboolean 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.
-
deleteData(offset, count)
-
Remove a quantidade especificada de caracteres, iniciando no offset informado, da string #data.
Parameters:
Name Type Description offsetnumber Posição que define o início da seção a ser removida.
countnumber 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 newChildmodule:@nginstack/engine/lib/dom/Node~Node O nó a ser inserido.
refChildmodule:@nginstack/engine/lib/dom/Node~Node O nó antes do qual o newChild será inserido.
- Inherited From:
Returns:
O nó sendo inserido, que é newChild.
-
insertData(offset, data)
-
Insere o texto informado na posição indicada por offset em #data.
Parameters:
Name Type Description offsetnumber Posição onde data será inserido.
datastring 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 oldChildmodule:@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.
-
replaceChild(newChild, oldChild)
-
Substitui o elemento filho especificado por outro.
Parameters:
Name Type Description newChildmodule:@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.
oldChildmodule:@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.
-
replaceData(offset, count, data)
-
Substitui a quantidade de caracteres, iniciando a partir do offset informado, pela string informada.
Parameters:
Name Type Description offsetnumber Posição que define o início da seção a ser removida.
countnumber Quantidade de caracteres a partir de offset que serão removidos.
datastring 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 offsetnumber Posição inicial da qual será extraída uma substring.
countnumber Quantidade de caracteres que serão lidos a partir de offset.
Returns:
Substring da posição e tamanho informados.
- Type
- string