Manual de referência XML
- Página anterior Miscelânea XSD
- Próxima página Tipos de nós DOM
Manual de referência XML
- Tipo do nó
- Objeto Node
- Objeto NodeList
- Objeto NamedNodeMap
- Objeto Document
- Objeto Element
- Objeto Attr
- Objeto Text
- Objeto CDATASection
- Objeto Comment
- Objeto XMLHttpRequest
- XSD elements
- Definir o tratamento de caracteres de espaço em branco (quebras de linha, enter, espaços e tabulações).
- Funções de XSLT, XPath e XQuery no CodeW3C.com
Tipo do nó
A tabela a seguir lista os diferentes tipos de nós W3C e os elementos que eles podem ter:
Tipo do nó | 描述 | Elemento filho |
---|---|---|
Documento | Representa o documento inteiro (nó raiz da árvore DOM) |
|
DocumentFragment | Representa um objeto Document leve, que contém parte do documento. |
|
DocumentType | Fornece uma interface para a entidade definida para o documento. | Nenhum |
ProcessingInstruction | Representa a instrução de processamento. | Nenhum |
Referência de entidade | Representa o elemento de referência de entidade. |
|
Elemento | Representa o elemento (elemento) element. |
|
Attr | Representa o atributo. |
|
Text | Representa o conteúdo de texto de um elemento ou atributo. | Nenhum |
CDATASection | Representa o segmento CDATA do documento (o texto não é analisado pelo analisador). | Nenhum |
Comentário | Representa o comentário. | Nenhum |
Entidade | Representa a entidade. |
|
Notação | Representa o símbolo declarado no DTD. | Nenhum |
Tipo do nó - valor retornado
A tabela a seguir lista os valores que as propriedades nodeName e nodeValue podem retornar para cada tipo de nó:
Tipo do nó | Retorno do valor de nodeName | Retorno do valor de nodeValue |
---|---|---|
Documento | #documento | null |
DocumentFragment | #fragmento de documento | null |
DocumentType | Nome do doctype | null |
Referência de entidade | Nome da referência de entidade | null |
Elemento | Nome do elemento | null |
Attr | Nome do atributo | Valor do atributo |
ProcessingInstruction | target | Conteúdo do nó |
Comentário | #comment | Texto de comentário |
Text | #text | Conteúdo do Nó |
CDATASection | #cdata-section | Conteúdo do Nó |
Entidade | Nome da Entidade | null |
Notação | Nome do Símbolo | null |
NodeTypes - Constantes Nomes
NodeType | Constante Nomeada |
---|---|
1 | ELEMENT_NODE |
2 | ATTRIBUTE_NODE |
3 | TEXT_NODE |
4 | CDATA_SECTION_NODE |
5 | ENTITY_REFERENCE_NODE |
6 | ENTITY_NODE |
7 | PROCESSING_INSTRUCTION_NODE |
8 | COMMENT_NODE |
9 | DOCUMENT_NODE |
10 | DOCUMENT_TYPE_NODE |
11 | DOCUMENT_FRAGMENT_NODE |
12 | NOTATION_NODE |
Objeto Node do XML DOM
Atributos do objeto Node
Property | 描述 |
---|---|
attributes | NamedNodeMap contendo os atributos deste nó (se este nó for um elemento). |
baseURI | Retorna o URI de base absoluto deste nó. |
childNodes | Retorna o NodeList de nós filhos do nó. |
firstChild | Retorna o primeiro nó filho do nó. |
lastChild | Retorna o último nó filho do nó. |
nextSibling | Retorna o nó同级 que segue o nó. |
nodeName | Retorne o nome do nó, dependendo do tipo. |
nodeType | Retorne o tipo do nó. |
nodeValue | Defina ou retorne o valor do nó, dependendo do tipo. |
ownerDocument | Retorna o elemento raiz do nó (objeto document). |
parentNode | Retorna o nó pai do nó. |
prefix | Definir ou retornar o prefixo de namespace do nó. |
previousSibling | Retorna o nó同级 que precede o nó. |
textContent | Definir ou retornar o conteúdo de texto do nó e seus descendentes. |
Métodos do objeto Node
Método | 描述 |
---|---|
appendChild() | Adiciona um novo nó filho ao final da lista de nós filhos do nó. |
cloneNode() | Clonar nó. |
compareDocumentPosition() | Comparar a posição de dois nós no DOM hierárquico (documento). |
getFeature()feature,version) | Retorna o objeto DOM que implementa a API específica para o recurso e a versão especificados. |
getUserData()key) |
Retorna o objeto associado à chave do nó. Deve primeiro configurar o objeto neste nó, usando o mesmo chave para chamar setUserData. |
hasAttributes() | Retorna true se o nó especificado tiver qualquer atributo, caso contrário retorna false. |
hasChildNodes() | Retorna true se o nó especificado tiver nós filhos, caso contrário retorna false. |
insertBefore() | Insere um novo nó filho antes do nó filho especificado. |
isDefaultNamespace(URI) | Retorna se o URI de namespace especificado é o padrão. |
isEqualNode() | Verificar se dois nós são iguais. |
isSameNode() | Verifica se dois nós são o mesmo nó. |
lookupNamespaceURI() | Retorna o URI de namespace associado ao prefixo dado. |
lookupPrefix() | Retorna o prefixo associado ao URI de namespace dado. |
normalize() | Mesclar nós de texto adjacentes e excluir nós de texto vazios. |
removeChild() | Excluir (e retornar) o nó filho especificado do nó atual. |
replaceChild() | Substituir o nó filho por um novo nó. |
setUserData(key,data,handler) | Associar o objeto ao chave do nó. |
Objeto NodeList do XML DOM
Atributos do objeto NodeList
Property | 描述 |
---|---|
length | Retorna o número de nós na lista NodeList. |
Métodos do objeto NodeList
Método | 描述 |
---|---|
item() | Retorna o nó na posição especificada da lista de nós. |
Objeto NamedNodeMap do XML DOM
Atributos do objeto NamedNodeMap
Property | 描述 |
---|---|
length | Retorne o número de nós na lista. |
Métodos do objeto NamedNodeMap
Método | 描述 |
---|---|
getNamedItem() | Retorne o nó com nome específico. |
getNamedItemNS() | Retorne o nó com nome e espaço de nomes específicos. |
item() | Retorne o nó no índice específico. |
removeNamedItem() | Remova o nó com nome específico. |
removeNamedItemNS() | Remova o nó com nome e espaço de nomes específicos. |
setNamedItem() | Defina o nó específico (por nome). |
setNamedItemNS() | Defina o nó específico (por nome e espaço de nomes). |
Objeto Document do XML DOM
Atributos do objeto Document
Property | 描述 |
---|---|
childNodes | Retorne a NodeList de nós filhos do documento. |
doctype | Retorne a declaração de tipo de documento associada ao documento. |
documentElement | Retorne o nó raiz do documento. |
documentURI | Defina ou retorne a posição do documento. |
domConfig | Retorne a configuração usada ao chamar normalizeDocument(). |
firstChild | Retorne o primeiro nó filho do documento. |
implementation | Retorne o objeto DOMImplementation que processa este documento. |
inputEncoding | Retorne o modo de codificação usado pelo documento (ao analisar). |
lastChild | Retorne o último nó filho do documento. |
nodeName | Retorne o nome do nó (dependendo do seu tipo). |
nodeType | Retorne o tipo de nó do nó. |
nodeValue | Defina ou retorne o valor do nó (dependendo do seu tipo). |
xmlEncoding | Retorne o modo de codificação XML do documento. |
xmlStandalone | Defina ou retorne se o documento é independente. |
xmlVersion | Defina ou retorne a versão XML do documento. |
Métodos do objeto Document
Método | 描述 |
---|---|
adoptNode() | Adote um nó de outro documento para este documento e retorne o nó adotado. |
createAttribute() | Crie um nó de atributo com nome especificado e retorne o novo objeto Attr. |
createAttributeNS() | Crie um nó de atributo com nome e espaço de nomes especificados e retorne o novo objeto Attr. |
createCDATASection() | Crie um nó de seção CDATA. |
createComment() | Crie um nó de comentário. |
createDocumentFragment() | Crie um objeto DocumentFragment vazio e retorne-o. |
createElement() | Cria um nó de elemento. |
createElementNS() | Cria um nó de elemento com o espaço de nomes especificado. |
createEntityReference() | Cria um objeto EntityReference e retorna este objeto. |
createProcessingInstruction() | Cria um objeto ProcessingInstruction e retorna este objeto. |
createTextNode() | Cria um nó de texto. |
getElementById() | Retorna o elemento que possui a propriedade id com o valor especificado. |
getElementsByTagName() | Retorna NodeList de todos os elementos que possuem o nome especificado. |
getElementsByTagNameNS() | Retorna NodeList de todos os elementos que possuem o nome e o espaço de nomes especificados. |
importNode() | Importa um nó de outro documento para este documento. |
normalizeDocument() | |
renameNode() | Renomeia o nó de elemento ou nó de atributo. |
Propriedades do objeto DocumentType
Cada documento tem uma propriedade DOCTYPE, cujo valor é null ou um objeto DocumentType.
O objeto DocumentType fornece a interface para entidades definidas para o documento XML.
Property | 描述 |
---|---|
name | Retorna o nome do DTD. |
publicId | Retorna o identificador público do DTD. |
systemId | Retorna o identificador de sistema do DTD externo. |
Métodos do objeto DocumentImplementation
O objeto DOMImplementation executa operações específicas de instância independentes do modelo de objeto do documento.
Método | 描述 |
---|---|
createDocument() | Cria um novo objeto DOM Document do tipo documento especificado. |
createDocumentType() | Cria um nó DocumentType vazio. |
getFeature() | Retorna o objeto API que implementa a característica e a versão especificada (se houver). |
hasFeature() | Verifica se a implementação DOM implementou características específicas e versões. |
Propriedades do objeto ProcessingInstruction
O objeto ProcessingInstruction representa a instrução de processamento.
As instruções de processamento são usadas como método para manter informações específicas do processador no texto do documento XML.
Property | 描述 |
---|---|
data | Define ou retorna o conteúdo da instrução de processamento. |
target | Retorna o alvo da instrução de processamento. |
Objeto Element do XML DOM
Propriedades do objeto Element.
Property | 描述 |
---|---|
attributes | Retorna o NamedNodeMap da propriedade do elemento. |
baseURI | Retorna o URI de referência absoluta do elemento. |
childNodes | Retorna NodeList que contém nós filhos do elemento. |
firstChild | Retorna o primeiro nó filho do elemento. |
lastChild | Retorna o último nó filho do elemento. |
localName | Retorna a parte local do nome do elemento. |
namespaceURI | Retorna o URI de espaço de nomes do elemento. |
nextSibling | Retorna o nó imediatamente após o elemento. |
nodeName | Retorna o nome do nó, dependendo do tipo. |
nodeType | Retorne o tipo do nó. |
ownerDocument | Retorna o elemento raiz (objeto documento). |
parentNode | Retorna o nó pai do elemento. |
prefix | Definir ou retornar o prefixo de espaço de nomes do elemento. |
previousSibling | Retorna o nó imediatamente antes do elemento. |
schemaTypeInfo | Retorna as informações de tipo associadas ao elemento. |
tagName | Retorna o nome do elemento. |
textContent | Definir ou retornar o conteúdo de texto do elemento e seus descendentes. |
Métodos do objeto Elemento
Método | 描述 |
---|---|
appendChild() | Adicionar novo nó filho ao final da lista de nós filhos do nó. |
cloneNode() | Clonar nó. |
compareDocumentPosition() | Comparar a posição do documento de dois nós. |
getAttribute() | Retorna o valor do atributo. |
getAttributeNS() | Retorna o valor do atributo (com espaço de nomes). |
getAttributeNode() | Retorna nó de atributo como objeto Attribute. |
getAttributeNodeNS() | Retorna nó de atributo (com espaço de nomes) como objeto Attribute. |
getElementsByTagName() | Retorna NodeList que contém nós de elementos que correspondem ao nó de elemento especificado e seus nós filhos. |
getElementsByTagNameNS() | Retorna NodeList que contém nós de elementos que correspondem ao nó de elemento especificado (com espaço de nomes) e seus nós filhos. |
getFeature()feature,version) | Retorna o objeto DOM que implementa a API específica para o recurso e a versão especificados. |
getUserData()key) | Retorna o objeto associado à chave no nó. Deve primeiro configurar o objeto neste nó, usando o mesmo chave para chamar setUserData. |
hasAttribute() | Retorna se o elemento possui um atributo que correspondente ao nome especificado. |
hasAttributeNS() | Retorna se o elemento possui um atributo que correspondente ao nome e ao espaço de nomes especificados. |
hasAttributes() | Retorna se o elemento possui atributos. |
hasChildNodes() | Retorna se o elemento tem nós filhos. |
insertBefore() | Inserir um novo nó filho antes do nó filho existente. |
isDefaultNamespace(URI) | Retorna se o specified namespaceURI é o padrão. |
isEqualNode() | Verificar se dois nós são iguais. |
lookupNamespaceURI() | Retorna o URI de namespace que coincide com o prefixo especificado. |
lookupPrefix() | Retorna o prefixo que coincide com o URI de namespace especificado. |
normalize() |
O método normalize() remove os nós de texto vazios e conecta os nós de texto adjacentes. Normaliza todos os nós de texto sob o elemento (inclusive atributos), onde apenas a estrutura (por exemplo, elementos, comentários, instruções de processamento, partes CDATA e referências de entidade) separa os nós de texto. Ou seja, não existem nós de texto adjacentes nem nós de texto vazios. |
removeAttribute() | Remover o atributo especificado. |
removeAttributeNS() | Remover o atributo especificado (com namespace). |
removeAttributeNode() | Remover o nó de atributo especificado. |
removeChild() | Remover nó filho. |
replaceChild() | Substituir o nó filho. |
setUserData(key,data,handler) | Associar o objeto com a chave no elemento. |
setAttribute() | Adiciona um novo atributo. |
setAttributeNS() | Adiciona um novo atributo (com namespace). |
setAttributeNode() | Adiciona um novo nó de atributo. |
setAttributeNodeNS(attrnode) | Adiciona um novo nó de atributo (com namespace). |
setIdAttribute(name,isId) | Se o atributo isId do objeto Attribute for true, este método declara o atributo especificado como atributo ID determinado pelo usuário. |
setIdAttributeNS(uri,name,isId) | Se o atributo isId do objeto Attribute for true, este método declara o atributo especificado (com namespace) como atributo ID determinado pelo usuário. |
setIdAttributeNode(idAttr,isId) | Se o atributo isId do objeto Attribute for true, este método declara o atributo especificado como atributo ID determinado pelo usuário. |
Atributos do objeto Attr
Property | 描述 |
---|---|
baseURI | Retorna o URI de base absoluto do atributo. |
isId | Se o atributo é do tipo id, retorna true, caso contrário, retorna false. |
localName | Retorna a parte local do nome do atributo. |
name | Retorna o nome do atributo. |
namespaceURI | Retorna o URI de namespace do atributo. |
nodeName | Retorne o nome do nó, dependendo do tipo. |
nodeType | Retorne o tipo do nó. |
nodeValue | Defina ou retorne o valor do nó, dependendo do tipo. |
ownerDocument | Retorne o elemento raiz (objeto documento) do atributo. |
ownerElement | Retorne o nó de elemento ao qual o atributo está anexado. |
prefix | Defina ou retorne o prefixo do espaço de nomes do atributo. |
schemaTypeInfo | Retorne as informações do tipo associadas ao atributo. |
specified |
Se o valor do atributo for configurado no documento, retorne true; Se o valor do atributo for o valor padrão DTD/Schema, retorne false. |
textContent | Defina ou retorne o conteúdo de texto do atributo. |
value | Defina ou retorne o valor do atributo. |
Objeto Text do XML DOM
Atributo do objeto Text
Property | 描述 |
---|---|
data | Defina ou retorne o texto do elemento ou atributo. |
isElementContentWhitespace | Verifique se o nó de texto contém conteúdo de caracteres em branco. |
length | Retorne o comprimento do texto do elemento ou atributo. |
wholeText | Retorne todos os textos adjacentes ao nó, conectados em ordem de documento. |
Métodos do objeto Text
Método | 描述 |
---|---|
appendData() | Adicione dados ao nó. |
deleteData() | Exclua dados do nó. |
insertData() | Insira dados no nó. |
replaceData() | Substitui os dados do nó. |
replaceWholeText(text) | Substitua o texto do nó e de todos os nós de texto adjacentes com o texto especificado. |
splitText() | Divida um nó Text em dois. |
substringData() | Extrai dados do nó. |
Objeto CDATASection do XML DOM
Atributos do objeto CDATASection
Property | 描述 |
---|---|
data | Defina ou retorne o texto do nó. |
length | Retorne o comprimento da parte CDATA. |
Métodos do objeto CDATASection
Método | 描述 |
---|---|
appendData() | Adicione dados ao nó. |
deleteData() | Exclua dados do nó. |
insertData() | Insira dados no nó. |
replaceData() | Substitui os dados do nó. |
splitText() | Divida o nó CDATA em dois nós. |
substringData() | Extrai dados do nó. |
Objeto Comment do XML DOM
Atributos do objeto Comment
Property | 描述 |
---|---|
data | Defina ou retorne o texto do nó. |
length | Retorne o comprimento do texto do nó. |
Métodos do objeto Comment
Método | 描述 |
---|---|
appendData() | Adicione dados ao nó. |
deleteData() | Exclua dados do nó. |
insertData() | Insira dados no nó. |
replaceData() | Substitui os dados do nó. |
substringData() | Extrai dados do nó. |
Objeto XMLHttpRequest do XML DOM
Métodos do objeto XMLHttpRequest
Método | 描述 |
---|---|
abort() | Cancela a solicitação atual. |
getAllResponseHeaders() | Retorne as informações de cabeçalho. |
getResponseHeader() | Retorne o valor do cabeçalho HTTP especificado. |
open(method,url,async,uname,pswd) |
Especifique o tipo de solicitação, URL, se a solicitação deve ser processada de forma assíncrona e outras propriedades opcionais da solicitação.
|
send(string) |
Send the request to the server. string: Only used for POST requests |
setRequestHeader() | Add a label/value pair to the headers to be sent. |
XMLHttpRequest object properties
Property | 描述 |
---|---|
onreadystatechange | Store the function (or function name) that is automatically called when the readyState attribute changes. |
readyState |
Save the state of XMLHttpRequest. Changes from 0 to 4:
|
responseText | Return response data as a string. |
responseXML | Return response data as XML data. |
status | Return status code (for example, "404" for "Not Found", or "200" for "OK"). |
statusText | Return status text (for example, "Not Found" or "OK"). |
XSD elements
elemento XSLT | Explain |
---|---|
all | Specify that child elements can appear in any order, and each child element can appear zero or once. |
annotation | The annotation element is a top-level element that specifies schema annotations. |
any | Allow creators to extend XML documents by using elements not specified by the schema. |
anyAttribute | Allow creators to extend XML documents by using attributes not specified by the schema. |
appInfo | Specify the information that the application should use in the annotation element. |
Aplicar um template ao elemento atual ou a seus subelementos. | Define an attribute. |
attributeGroup | Define an attribute group used in the complex type definition. |
choice | Allow only one element to appear within the containing elements in a <choice> declaration. |
complexContent | Define extensions or restrictions on complex types (including mixed content or elements only). |
complexType | Define complex types. |
documentation | Define text annotations in the schema. |
element | Define an element. |
extension | Expand existing simpleType or complexType elements. |
field | Specify an XPath expression that defines the value used to define the identification constraint. |
group | Define the element group used in the definition of complex types. |
import | Add multiple schemas with different target namespaces to a document. |
include | Add multiple schemas with the same target namespace to a document. |
key | Specify that the value of an attribute or element (or a set of values) must be a key within a specified range. |
keyref | Specify that the value of an attribute or element (or a set of values) corresponds to the value of a specified key or unique element. |
list | Define a simple type as a list of values of a specified data type. |
notation | Describe the format of non-XML data in an XML document. |
redefine | Redefine simple and complex types, groups, and attribute groups obtained from an external schema file. |
restriction | Define constraints on simpleType, simpleContent, or complexContent. |
schema | Define the root element of the schema. |
selector | Specify an XPath expression that selects a set of elements for the identification constraint. |
sequence | The child elements must appear in order. Each child element can appear 0 to any number of times. |
simpleContent | Contains extensions or restrictions of the complexType element and does not contain any elements. |
simpleType | Define a simple type, specifying constraints and information about the values of attributes or elements that contain only text. |
union | Define a collection defined by multiple simpleType definitions. |
unique | Specify that the value of an attribute or element (or a combination of attribute or element values) must be unique within a specified range. |
XSD constraints for data types
Limit | 描述 |
---|---|
enumeration | Define a list of acceptable values |
fractionDigits | Define the maximum number of decimal places allowed. It must be greater than or equal to 0. |
length | Define the exact number of allowed characters or list items. It must be greater than or equal to 0. |
maxExclusive | Define the upper limit of a number. The allowed values must be less than this value. |
maxInclusive | Define the upper limit of a number. The allowed values must be less than or equal to this value. |
maxLength | Define the maximum number of allowed characters or list items. It must be greater than or equal to 0. |
minExclusive | Define the lower limit of a number. The allowed values must be greater than this value. |
minInclusive | Define the lower limit of a number. The allowed values must be greater than or equal to this value. |
minLength | Definir o número mínimo de caracteres permitidos ou itens da lista. Deve ser maior ou igual a 0. |
Definir o número mínimo de caracteres permitidos ou itens da lista. Deve ser maior ou igual a 0. | pattern |
Definir a sequência exata de caracteres aceitáveis. | totalDigits |
Definir o número exato de dígitos de números árabes permitidos. Deve ser maior que 0. | whiteSpace |
Definir o tratamento de caracteres de espaço em branco (quebras de linha, enter, espaços e tabulações).
elemento XSLT | 描述 |
---|---|
element | apply-imports |
Aplicar regras de template vindas de uma folha de estilo importada. | apply-templates |
Aplicar um template ao elemento atual ou a seus subelementos. | Adicionar atributos ao elemento. |
attribute-set | Criar um conjunto de atributos nomeados. |
call-template | Chamar um template específico. |
choose | Usado em conjunto com <when> e <otherwise> para expressar testes de condições múltiplas. |
comment | Criar um nó de comentário no árvore de resultados. |
copy | Criar uma cópia do nó atual (sem subnós e atributos). |
copy-of | Criar uma cópia do nó atual (com subnós e atributos). |
decimal-format | Definir os caracteres e símbolos a serem usados ao converter números em strings usando a função format-number(). |
element | Criar um nó de elemento no documento de saída. |
fallback | Se o processador não suportar um elemento XSLT, especificar um código alternativo para executar. |
for-each | Iterar sobre cada nó em um conjunto de nós especificado. |
if | Incluir um template, aplicando-o apenas se uma condição específica for verdadeira. |
import | Usado para injetar o conteúdo de uma folha de estilo em outra folha de estilo. |
include | Incluir o conteúdo de uma folha de estilo em outra folha de estilo. |
key | Declarar uma chave nomeada. |
message | Escrever uma mensagem na saída (usada para relatórios de erro). |
namespace-alias | Substituir o espaço de nomes do estilo de folha de estilo por um espaço de nomes diferente na saída. |
number | Determinar a posição inteira do nó atual e formatar o número. |
otherwise | Especificar a ação padrão do elemento <choose>. |
output | Definir o formato do documento de saída. |
param | Declarar um parâmetro local ou global. |
preserve-space | Usado para definir elementos que devem preservar espaços em branco. |
processing-instruction | Gerar um nó de instrução de processamento. |
sort | Ordenar os resultados. |
strip-space | Definir o elemento que deve remover caracteres de espaço em branco. |
stylesheet | define o elemento raiz do estilo. |
template | regras aplicadas quando o nó especificado é correspondido. |
text | gera nós de texto através do estilo. |
transform | define o elemento raiz do estilo. |
value-of | extrai o valor do nó selecionado. |
variable | declara variáveis locais ou globais. |
when | especifica a ação do elemento <choose>. |
with-param | especifica o valor do parâmetro a ser传入某个模板. |
Funções de XSLT, XPath e XQuery no CodeW3C.com
- acesso
- erro e rastreamento
- número
- string
- AnyURI
- lógica
- duração/data/hora
- QName
- nó
- sequência
- Contexto
- funções integradas
funções de acesso
名称 | Description |
---|---|
fn:node-name(node) | retorna o nome do nó do parâmetro. |
fn:nilled(node) | retorna um valor booleano indicando se o nó do parâmetro foi recusado. |
fn:data(item.item,...) | aceita uma sequência de itens e retorna uma sequência de valores atômicos. |
|
retorna o valor da propriedade base-uri do nó atual ou do nó especificado. |
fn:document-uri(node) | retorna o valor da propriedade document-uri do nó especificado. |
funções de erro e rastreamento
名称 | Description |
---|---|
|
exemplo: error(fn:QName('http://example.com/test', 'err:toohigh'), 'Erro: Preço é muito alto') resultado: retorna ao ambiente de processamento externo http://example.com/test#toohigh e a string "Erro: Preço é muito alto". |
fn:trace(value,label) | usado para debugar consultas. |
funções numéricas
名称 | Description |
---|---|
fn:number(arg) |
retorna o valor numérico do parâmetro. O parâmetro pode ser um valor booleano, uma string ou um conjunto de nós. exemplo: number('100') resultado: 100 |
fn:abs(num) |
retorna o valor absoluto do parâmetro. exemplo: abs(3.14) resultado: 3.14 exemplo: abs(-3.14) resultado: 3.14 |
fn:teto(num) |
retorna o menor inteiro maior que o parâmetro num. exemplo: teto(3.14) Resultado: 4 |
fn:floor(num) |
Retorna o maior inteiro não superior ao parâmetro num. Exemplo: floor(3.14) Result: 3 |
fn:round(num) |
Arredonda o parâmetro num para o inteiro mais próximo. Exemplo: round(3.14) Result: 3 |
fn:round-half-to-even() |
Exemplo: round-half-to-even(0.5) Resultado: 0 Exemplo: round-half-to-even(1.5) Result: 2 Exemplo: round-half-to-even(2.5) Result: 2 |
Funções de string
名称 | Description |
---|---|
fn:string(arg) |
Retorna o valor de string do argumento. O argumento pode ser um número, um valor lógico ou um conjunto de nós. Exemplo: string(314) Resultado: "314" |
fn:codepoints-to-string(int,int,...) |
Retorna uma string de uma sequência de código-pontos. Exemplo: codepoints-to-string(84, 104, 233, 114, 232, 115, 101) Resultado: 'Thérèse' |
fn:string-to-codepoints(string) |
Retorna uma sequência de código-pontos de uma string. Exemplo: string-to-codepoints("Thérèse") Resultado: 84, 104, 233, 114, 232, 115, 101 |
fn:codepoint-equal(comp1,comp2) | De acordo com a comparação de código-ponto Unicode, se o valor de comp1 for igual ao valor de comp2, retorna true. (http://www.w3.org/2005/02/xpath-functions/collation/codepoint), caso contrário, retorna false. |
|
Se comp1 for menor que comp2, retorna -1. Se comp1 for igual a comp2, retorna 0. Se comp1 for maior que comp2, retorna 1. (De acordo com as regras de comparação utilizadas). Exemplo: compare('ghi', 'ghi') Resultado: 0 |
fn:concat(string,string,...) |
Retorna a concatenação de strings. Exemplo: concat('XPath ','é ','DIVERTIDO!') Resultado: 'XPath é DIVERTIDO!' |
fn:join(string,string,...,sep) |
Usa o parâmetro sep como separador para retornar a string concatenada dos parâmetros string. Exemplo: string-join(('We', 'are', 'having', 'fun!'), ' ') O resultado: ' We are having fun! ' Exemplo: string-join(('We', 'are', 'having', 'fun!')) O resultado: 'Wearehavingfun!' Exemplo: string-join((), 'sep') O resultado: '' |
|
Retorna a substring de comprimento especificado a partir da posição start. O índice do primeiro caractere é 1. Se o parâmetro len for omitido, retorna a substring da posição start até o final da string. Exemplo: substring('Beatles',1,4) O resultado: 'Beat' Exemplo: substring('Beatles',2) O resultado: 'eatles' |
|
Retorna o comprimento da string especificada. Se não houver parâmetro string, retorna o comprimento do valor de string do nó atual. Exemplo: string-length('Beatles') O resultado: 7 |
|
Remove os espaços em branco no início e no final da string especificada, substitui todas as sequências de espaços internos por um único espaço e retorna o resultado. Se não houver parâmetro string, processa o nó atual. Exemplo: normalize-space(' The XML ') O resultado: 'The XML' |
fn:normalize-unicode() | Executa a normalização Unicode. |
fn:upper-case(string) |
Converte o parâmetro string em maiúsculas. Exemplo: upper-case('The XML') O resultado: 'THE XML' |
fn:lower-case(string) |
Converte o parâmetro string em minúsculas. Exemplo: lower-case('The XML') O resultado: 'the xml' |
fn:translate(string1,string2,string3) |
Substitui string2 por string3 dentro de string1. Exemplo: translate('12:30','30','45') Resultado: '12:45' Exemplo: translate('12:30','03','54') Resultado: '12:45' Exemplo: translate('12:30','0123','abcd') Resultado: 'bc:da' |
fn:escape-uri(stringURI,esc-res) |
Exemplo: escape-uri("http://example.com/test#car", true()) Resultado: "http%3A%2F%2Fexample.com%2Ftest#car" Exemplo: escape-uri("http://example.com/test#car", false()) Resultado: "http://example.com/test#car" Exemplo: escape-uri ("http://example.com/~bébé", false()) Resultado: "http://example.com/~b%C3%A9b%C3%A9" |
fn:contains(string1,string2) |
Se string1 contiver string2, retorna true, caso contrário, retorna false. Exemplo: contains('XML','XM') Resultados: true |
fn:starts-with(string1,string2) |
Se string1 começar com string2, retorna true, caso contrário, retorna false. Exemplo: starts-with('XML','X') Resultados: true |
fn:ends-with(string1,string2) |
Se string1 terminar com string2, retorna true, caso contrário, retorna false. Exemplo: ends-with('XML','X') resultado: false |
fn:substring-before(string1,string2) |
Retorna a substring que está antes da ocorrência de string2 dentro de string1. Exemplo: substring-before('12/10','/') Resultado: '12' |
fn:substring-after(string1,string2) |
Retorna a substring que está após a ocorrência de string2 dentro de string1. Exemplo: substring-after('12/10','/') Resultados: '10' |
fn:matches(string,pattern) |
Se o parâmetro string coincidir com o padrão especificado, retorna true, caso contrário, retorna false. Exemplo: matches("Merano", "ran") Resultados: true |
fn:replace(string,pattern,replace) |
Substitui o padrão especificado pelo parâmetro replace e retorna o resultado. Exemplo: replace("Bella Italia", "l", "*") Resultados: 'Be**a Ita*ia' Exemplo: replace("Bella Italia", "l", "") Resultados: 'Bea Itaia' |
fn:tokenize(string,pattern) |
Exemplo: tokenize("XPath is fun", "\s+") Resultados: ("XPath", "is", "fun") |
Funções para anyURI
名称 | Description |
---|---|
fn:resolve-uri(relative,base) |
Funções sobre valores booleanos
名称 | Description |
---|---|
fn:boolean(arg) | Retorna o valor booleano de um número, uma string ou um conjunto de nós. |
fn:not(arg) |
Primeiro, restaura o parâmetro a um valor booleano usando a função boolean(). Se o valor booleano for false, retorna true, caso contrário, retorna true. Exemplo: not(true()) resultado: false |
fn:true() |
Retorna o valor booleano true. Exemplo: true() Resultados: true |
fn:false() |
Retorna o valor booleano false. Exemplo: false() resultado: false |
Funções sobre duração, data e hora
Função de extração de componentes de data, hora e duração
名称 | Description |
---|---|
fn:dateTime(date,time) | Converte o parâmetro em data e hora. |
fn:years-from-duration(datetimedur) | Retorna o valor inteiro do ano do parâmetro, representado em termos padronizados. |
fn:months-from-duration(datetimedur) | Retorna o valor inteiro do mês do parâmetro, representado em termos padronizados. |
fn:days-from-duration(datetimedur) | Retorna o valor inteiro do dia do parâmetro, representado em termos padronizados. |
fn:hours-from-duration(datetimedur) | Retorna o valor inteiro da parte de horas do valor, representado em notação lexical padrão. |
fn:minutes-from-duration(datetimedur) | Retorna o valor inteiro da parte de minutos do valor, representado em notação lexical padrão. |
fn:seconds-from-duration(datetimedur) | Retorna o valor decimal da parte de minutos do valor, representado em notação lexical padrão. |
fn:year-from-dateTime(datetime) |
Retorna o valor inteiro da parte de anos do valor local do parâmetro. Exemplo: year-from-dateTime(xs:dateTime("2005-01-10T12:30-04:10")) Resultado: 2005 |
fn:month-from-dateTime(datetime) |
Retorna o valor inteiro da parte de meses do valor local do parâmetro. Exemplo: month-from-dateTime(xs:dateTime("2005-01-10T12:30-04:10")) Resultado: 01 |
fn:day-from-dateTime(datetime) |
Retorna o valor inteiro da parte de dias do valor local do parâmetro. Exemplo: day-from-dateTime(xs:dateTime("2005-01-10T12:30-04:10")) Resultado: 10 |
fn:hours-from-dateTime(datetime) |
Retorna o valor inteiro da parte de horas do valor local do parâmetro. Exemplo: hours-from-dateTime(xs:dateTime("2005-01-10T12:30-04:10")) Resultado: 12 |
fn:minutes-from-dateTime(datetime) |
Retorna o valor inteiro da parte de minutos do valor local do parâmetro. Exemplo: minutes-from-dateTime(xs:dateTime("2005-01-10T12:30-04:10")) Resultado: 30 |
fn:seconds-from-dateTime(datetime) |
Retorna o valor decimal da parte de segundos do valor local do parâmetro. Exemplo: seconds-from-dateTime(xs:dateTime("2005-01-10T12:30:00-04:10")) Resultado: 0 |
fn:timezone-from-dateTime(datetime) | Retorna a parte de fuso horário do parâmetro, se existir. |
fn:year-from-date(date) |
Retorna o valor local do parâmetro como inteiro representando o ano. Exemplo: year-from-date(xs:date("2005-04-23")) Resultado: 2005 |
fn:month-from-date(date) |
Retorna o inteiro que representa o mês no valor local do parâmetro. Exemplo: month-from-date(xs:date("2005-04-23")) Resultado: 4 |
fn:day-from-date(date) |
Retorna o inteiro que representa o dia no valor local do parâmetro. Exemplo: day-from-date(xs:date("2005-04-23")) Resultado: 23 |
fn:timezone-from-date(date) | Retorna a parte de fuso horário do parâmetro, se existir. |
fn:hours-from-time(time) |
Retorna o inteiro que representa a parte de horas no valor local do parâmetro. Exemplo: hours-from-time(xs:time("10:22:00")) Resultado: 10 |
fn:minutes-from-time(time) |
Retorna o inteiro que representa a parte de minutos no valor local do parâmetro. Exemplo: minutes-from-time(xs:time("10:22:00")) Resultado: 22 |
fn:seconds-from-time(time) |
Retorna o inteiro que representa a parte de segundos no valor local do parâmetro. Exemplo: seconds-from-time(xs:time("10:22:00")) Resultado: 0 |
fn:timezone-from-time(time) | Retorna a parte de fuso horário do parâmetro, se existir. |
fn:adjust-dateTime-to-timezone(datetime,timezone) |
Se o parâmetro timezone estiver vazio, retorna a dateTime sem fuso horário. Caso contrário, retorna a dateTime com fuso horário. |
fn:adjust-date-to-timezone(date,timezone) |
Se o parâmetro timezone estiver vazio, retorna a data sem fuso horário. Caso contrário, retorna a data com fuso horário. |
fn:adjust-time-to-timezone(time,timezone) |
Se o parâmetro timezone estiver vazio, retorna a data sem fuso horário. Caso contrário, retorna a data com fuso horário. |
Funções relacionadas a QNames
名称 | Description |
---|---|
fn:QName() | |
fn:local-name-from-QName() | |
fn:namespace-uri-from-QName() | |
fn:namespace-uri-for-prefix() | |
fn:in-scope-prefixes() | |
fn:resolve-QName() |
Funções de nó
名称 | Description |
---|---|
|
Retorna o nome do nó atual ou do primeiro nó do conjunto de nós especificado. |
|
Retorna o nome do nó atual ou do primeiro nó do conjunto de nós especificado - sem prefixo de espaço de nomes. |
|
Retorna o URI do espaço de nomes do nó atual ou do primeiro nó do conjunto de nós especificado. |
fn:lang(lang) |
Se o idioma do nó atual coincidir com o idioma especificado, retorna true. Exemplo: Lang("en") é verdadeiro para <p xml:lang="en">...</p> Exemplo: Lang("de") é falso para <p xml:lang="en">...</p> |
|
Retorna o nó raiz da árvore de nós do nó atual ou do nó especificado. Geralmente é o nó de documento. |
Funções de sequência
Função geral
名称 | Description |
---|---|
fn:index-of((item,item,...),searchitem) |
Retorna a posição dos itens na sequência de itens igual ao parâmetro searchitem. Exemplo: index-of ((15, 40, 25, 40, 10), 40) Resultado: (2, 4) Exemplo: index-of (("a", "dog", "and", "a", "duck"), "a") Resultado (1, 4) Exemplo: index-of ((15, 40, 25, 40, 10), 18) Resultado: () |
fn:remove((item,item,...),position) |
Retorna uma nova sequência construída pelo parâmetro item, enquanto remove o item especificado pela posição. Exemplo: remove(("ab", "cd", "ef"), 0) Resultado: ("ab", "cd", "ef") Exemplo: remove(("ab", "cd", "ef"), 1) Resultado: ("cd", "ef") Exemplo: remove(("ab", "cd", "ef"), 4) Resultado: ("ab", "cd", "ef") |
fn:empty(item,item,...) |
Se o valor do parâmetro for uma sequência vazia, retorna true, caso contrário, retorna false. Exemplo: empty(remove(("ab", "cd"), 1)) resultado: false |
fn:exists(item,item,...) |
se o valor do parâmetro não for uma sequência vazia, retorna true, caso contrário, retorna false. exemplo: exists(remove(("ab"), 1)) resultado: false |
fn:distinct-values((item,item,...),collation) |
retorna valores únicos diferentes. exemplo: distinct-values((1, 2, 3, 1, 2)) resultado: (1, 2, 3) |
fn:insert-before((item,item,...),pos,inserts) |
retorna uma nova sequência construída pelo parâmetro item, inserindo o valor do parâmetro inserts na posição especificada pelo parâmetro pos. exemplo: insert-before(("ab", "cd"), 0, "gh") resultado: ("gh", "ab", "cd") exemplo: insert-before(("ab", "cd"), 1, "gh") resultado: ("gh", "ab", "cd") exemplo: insert-before(("ab", "cd"), 2, "gh") resultado: ("ab", "gh", "cd") exemplo: insert-before(("ab", "cd"), 5, "gh") resultado: ("ab", "cd", "gh") |
fn:reverse((item,item,...)) |
retorna a ordem inversa dos itens especificados. exemplo: reverse(("ab", "cd", "ef")) resultado: ("ef", "cd", "ab") exemplo: reverse(("ab")) resultado: ("ab") |
fn:subsequence((item,item,...),start,len) |
retorna a sequência de itens especificada pelo parâmetro start, com comprimento especificado pelo parâmetro len. a posição do primeiro item é 1. exemplo: subsequence(($item1, $item2, $item3,...), 3) resultado: ($item3, ...) exemplo: subsequence(($item1, $item2, $item3, ...), 2, 2) resultado: ($item2, $item3) |
fn:unordered((item,item,...)) | retorna os itens com a ordem determinada pela implementação. |
função de teste de capacidade de sequência
名称 | Description |
---|---|
fn:zero-or-one(item,item,...) | If the parameter contains zero or one item, returns the parameter, otherwise generates an error. |
fn:one-or-more(item,item,...) | If the parameter contains one or more items, returns the parameter, otherwise generates an error. |
fn:exactly-one(item,item,...) | If the parameter contains an item, returns the parameter, otherwise generates an error. |
Equals, Union, Intersection and Except
名称 | Description |
---|---|
fn:deep-equal(param1,param2,collation) | Returns true if param1 and param2 are equal to each other (deep-equal), otherwise returns false. |
Aggregate functions
名称 | Description |
---|---|
fn:count((item,item,...)) | Returns the number of nodes. |
fn:avg((arg,arg,...)) |
Returns the average value of the parameter values. Example: avg((1,2,3)) Result: 2 |
fn:max((arg,arg,...)) |
Returns the parameter that is greater than the other parameters. Example: max((1,2,3)) Result: 3 Example: max(('a', 'k')) Result: 'k' |
fn:min((arg,arg,...)) |
Returns the parameter that is less than the other parameters. Example: min((1,2,3)) Result: 1 Example: min(('a', 'k')) Result: 'a' |
fn:sum(arg,arg,...) | Returns the sum of the numerical values of each node in the specified node set. |
Functions to generate sequences
名称 | Description |
---|---|
fn:id((string,string,...),node) | Returns a sequence of element nodes whose ID values equal one or more values specified in the string parameter. |
fn:idref((string,string,...),node) | Returns a sequence of element or attribute nodes whose IDREF values equal one or more values specified in the string parameter. |
fn:doc(URI) | |
fn:doc-available(URI) | Returns true if the doc() function returns a document node, otherwise returns false. |
|
Context functions
名称 | Description |
---|---|
fn:position() |
Returns the index position of the current node being processed. Example: //book[position()<=3] Result: Select the first three book elements |
fn:last() |
返回在被处理的节点列表中的项目数目。 例子://book[last()] 结果:选择最后一个 book 元素 |
fn:current-dateTime() | 返回当前的 dateTime(带有时区)。 |
fn:current-date() | 返回当前的日期(带有时区)。 |
fn:current-time() | 返回当前的时间(带有时区)。 |
fn:implicit-timezone() | 返回隐式时区的值。 |
fn:default-collation() | 返回默认对照的值。 |
fn:static-base-uri() | 返回 base-uri 的值。 |
XSLT 函数
此外,还有以下内置的 XSLT 函数:
名称 | 描述 |
---|---|
current() | 返回当前节点作为唯一成员的节点集。 |
document() | 用于访问外部 XML 文档中的节点。 |
element-available() | 检测 XSLT 处理器是否支持指定的元素。 |
format-number() | 把数字转换为字符串。 |
function-available() | 检测 XSLT 处理器是否支持指定的函数。 |
generate-id() | 返回唯一标识指定节点的字符串值。 |
key() | 检索以前使用 <xsl:key> 语句标记的元素。 |
node-set | 将树转换为节点集。产生的节点集总是包含单个节点并且是树的根节点。 |
system-property() | 返回系统属性的值。 |
unparsed-entity-uri() | 返回未解析实体的 URI。 |
其他 XML DOM 对象
- DOM CharacterData
- DOM CSS2Properties
- DOM CSSRule
- DOM CSSStyleRule
- DOM CSSStyleSheet
- DOM DocumentType
- DOM DOMException
- DOM Implementation
- DOM DOMParser
- DOM Event
- DOM HTMLCollection
- DOM HTMLDocument
- DOM HTMLElement
- DOM ProcessingInstr
- DOM Range
- DOM RangeException
- DOM XMLSerializer
- DOM XPathExpression
- DOM XPathResult
- DOM XSLTProcessor
- Página anterior Miscelânea XSD
- Próxima página Tipos de nós DOM