Manwal ng XML

Manwal ng XML

Uri ng puno

Ang sumusunod na talahanayan ay naglalarawan ng iba't ibang uri ng mga puno ng W3C, at ang kanilang magkakaroon na mga anak na elemento:

Uri ng puno 描述 Anak na elemento
Document Naglalarawan ng buong dokumento (root na puno ng DOM tree)
  • Element (max. one)
  • ProcessingInstruction
  • Comment
  • DocumentType
DocumentFragment Naglalarawan ng liwanag na Document object, na naglalaman ng isang bahagi ng dokumento.
  • ProcessingInstruction
  • Comment
  • Text
  • CDATASection
  • EntityReference
DocumentType Nagbibigay ng daan sa entity na idinagdag sa dokumento. None
ProcessingInstruction Naglalarawan ng instruction ng pagproseso. None
EntityReference Naglalarawan ng elemento ng pagsusukat ng entidad.
  • ProcessingInstruction
  • Comment
  • Text
  • CDATASection
  • EntityReference
Element Naglalarawan ng elemento (element) na element.
  • Text
  • Comment
  • ProcessingInstruction
  • CDATASection
  • EntityReference
Attr Naglalarawan ng attribute.
  • Text
  • EntityReference
Text Naglalarawan ng teksto sa elemento o attribute. None
CDATASection Naglalarawan ng section ng CDATA sa dokumento (ang teksto ay hindi naaayos ng parser) None
Comment Naglalarawan ng komentaryo. None
Entity Naglalarawan ng entidad.
  • ProcessingInstruction
  • Comment
  • Text
  • CDATASection
  • EntityReference
Notation Naglalarawan ng simbolo na idinagdag sa DTD. None

Uri ng puno - ang halaga na ibabalik

Ang sumusunod na talahanayan ay naglalarawan ng iba't ibang uri ng mga puno ng W3C, at ang kanilang magkakaroon na mga anak na elemento:

Uri ng puno Halaga ng pagbabalik ng nodeName Halaga ng pagbabalik ng nodeValue
Document #document null
DocumentFragment #document fragment null
DocumentType Pangalan ng doctype null
EntityReference Pangalan ng pagsusukat ng entidad null
Element element name null
Attr Pangalan ng attribute Halaga ng attribute
ProcessingInstruction target Nilalaman ng puno
Comment #comment Komentaryong teksto
Text #text Nilalaman ng node
CDATASection #cdata-section Nilalaman ng node
Entity Pangalan ng entity null
Notation Pangalan ng simbolo null

NodeTypes - may pangalan na konstante

NodeType Named Constant
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

Top

XML DOM Node 對象

Mga katangian ng Node object

Atribute 描述
attributes Naglalaan ng NamedNodeMap ng mga katangian na nasa node (kung ang node ay element).
baseURI Naglalaan ng absolute base URI ng node.
childNodes Naglalaan ng NodeList ng mga anak na node ng node.
firstChild Naglalaan ng unang anak na node ng node.
lastChild Naglalaan ng huling anak na node ng node.
nextSibling Naglalaan ng同级 node na sumunod sa tinukoy na同级 node.
nodeName Ibalik ang pangalan ng node, ayon sa uri nito.
nodeType Ibalik ang uri ng uri ng node.
nodeValue Itatalaga o ihatid ang halaga ng node, ayon sa uri nito.
ownerDocument Naglalaan ng unang elementong root ng node (dokumentong object).
parentNode Naglalaan ng magulang na node ng node.
prefix I-set o ibalik ang pangalan ng prefix ng namespace ng node.
previousSibling I-set o ibalik ang kaugnay na同级 node bago ang tinukoy na同级 node.
textContent I-set o ibalik ang teksto ng nilalaman ng node at ng kanyang lahat na haharap.

Mga paraan ng Node object

Paraan 描述
appendChild() Idagdag ang bagong anak na node sa katapusan ng listahan ng mga anak na node ng node.
cloneNode() Pagkopya ng node.
compareDocumentPosition() Ihahambing ang posisyon ng dalawang node sa DOM hierarchy (dokumentong).
getFeature(feature,version) Nagbibigay ng DOM object na naglalapat ng natukoy na katangian at bersyon na专用 API.
getUserData(key)

Naglalaan ng object na nauugnay sa key na nasa node.

Dapat ma-set ang object sa kasalukuyang node, sa pamamagitan ng paggamit ng parehong key sa setUserData.

hasAttributes() Kung mayroon ang tinukoy na node ang anumang mga katangian, ibalik ang true, kung wala ibalik ang false.
hasChildNodes() Kung mayroon ang tinukoy na node ang mga anak na node, ibalik ang true, kung hindi ibalik ang false.
insertBefore() Iinsert ang bagong anak na node bago ang tinukoy na anak na node.
isDefaultNamespace(URI) Susuriin kung ang binigay na uri ng namespace ay pangunahin.
isEqualNode() Suriin kung ang dalawang node ay katulad.
isSameNode() Susuriin kung ang dalawang node ay magkakapareho.
lookupNamespaceURI() Naglalaan ng uri ng namespace na nauugnay sa binigay na pangalan.
lookupPrefix() Naglalaan ng pangalan ng uri ng namespace na nauugnay sa binigay na uri.
normalize() Ihahambing at tanggalin ang magkakasunod na text node at tanggalin ang walang laman na text node.
removeChild() Tanggalin (at ibalik) ang partikular na anak na node ng kasalukuyang node.
replaceChild() Pumalit ng bagong node sa mga anak na node.
setUserData(key,data,handler) Ipagkakabit ang object sa pamamagitan ng key na nasa node.

Top

XML DOM NodeList 對象

Mga katangian ng NodeList object

Atribute 描述
length Naglalaan ng bilang ng mga node sa listahan ng node.

Mga paraan ng NodeList object

Paraan 描述
item() Naglalaan ng listahan ng node ang node na nasa ilalim ng partikular na index.

Top

XML DOM NamedNodeMap 對象

Mga attribute ng NamedNodeMap object

Atribute 描述
length Ibalik ang bilang ng mga node sa listahan.

Mga paraan ng NamedNodeMap object

Paraan 描述
getNamedItem() Ibalik ang node na may tinukoy na pangalan.
getNamedItemNS() Ibalik ang node na may tinukoy na pangalan at namespace.
item() Ibalik ang node na nasa tinukoy na index.
removeNamedItem() Tanggalin ang node na may tinukoy na pangalan.
removeNamedItemNS() Tanggalin ang node na may tinukoy na pangalan at namespace.
setNamedItem() Iset ang tinukoy na node (ayon sa pangalan).
setNamedItemNS() Iset ang tinukoy na node (ayon sa pangalan at namespace).

Top

XML DOM Document 對象

Mga attribute ng Document object

Atribute 描述
childNodes Ibalik ang NodeList ng mga anak na node ng dokumento.
doctype Ibalik ang deklarasyon ngDOCTYPE na nauugnay sa dokumento.
documentElement Ibalik ang pangunahing node ng dokumento.
documentURI Iset o ibalik ang posisyon ng dokumento.
domConfig Ibalik ang konfigurasyon na ginamit sa pag-normalize ng dokumento().
firstChild Ibalik ang unang anak na node ng dokumento.
implementation Ibalik ang DOMImplementation object na nagpaproseso ng dokumento.
inputEncoding Ibalik ang paraan ng encoding na ginamit ng dokumento (sa oras ng pagsasalin).
lastChild Ibalik ang huling anak na node ng dokumento.
nodeName Ibalik ang pangalan ng node (depende sa uri ng node).
nodeType Ibalik ang uri ng uri ng node.
nodeValue Iset o ibalik ang halaga ng node ( depende sa uri ng node).
xmlEncoding Ibalik ang paraan ng encoding ng XML ng dokumento.
xmlStandalone Iset o ibalik kung ang dokumento ay malayang nakakabit.
xmlVersion Iset o ibalik kung ang dokumento ay may XML bersyon.

Mga paraan ng Document object

Paraan 描述
adoptNode() Tanggapin ang isang node mula sa ibang dokumento sa kasalukuyang dokumento, at ibalik ang tanggapang node.
createAttribute() Lumikha ng isang Attr object na may tinukoy na pangalan, at ibalik ang bagong Attr object.
createAttributeNS() Lumikha ng isang Attr object na may tinukoy na pangalan at namespace, at ibalik ang bagong Attr object.
createCDATASection() Lumikha ng isang section ng CDATA.
createComment() Lumikha ng isang node ng puna.
createDocumentFragment() Lumikha ng walang laman na DocumentFragment object at ibalik ito.
createElement() Lumikha ng element node.
createElementNS() Lumikha ng element node na may tinukoy na namespace.
createEntityReference() Lumikha ng EntityReference object, at ibabalik ang object na ito.
createProcessingInstruction() Lumikha ng ProcessingInstruction object, at ibabalik ang object na ito.
createTextNode() Lumikha ng text node.
getElementById() Nagpalilipat ng element na may tinukoy na halaga ng id attribute.
getElementsByTagName() Nagpalilipat ng NodeList ng lahat ng element na may tinukoy na pangalan.
getElementsByTagNameNS() Nagpalilipat ng NodeList ng lahat ng element na may tinukoy na pangalan at namespace.
importNode() Iimportahin ang node mula sa ibang dokumento sa kasalukuyang dokumento.
normalizeDocument()
renameNode() Ayusin ang pangalan ng element node o attribute node.

Katangian ng DocumentType object

Ang bawat dokumento ay may isang DOCTYPE attribute, na may halaga na null o DocumentType object.

Ang DocumentType object ay nagbibigay ng interface para sa entity na tinukoy ng XML dokumento.

Atribute 描述
name Nagpalilipat ng pangalan ng DTD.
publicId Nagpalilipat ng public identifier ng DTD.
systemId Nagpalilipat ng system identifier ng panlabas na DTD.

Mga paraan ng DocumentImplementation object

Ang DocumentImplementation object ay nagpapatupad ng mga operasyon na hindi nakasalalay sa dokumentong object model.

Paraan 描述
createDocument() Nagpalilipat ng bagong DOM Document object na may tinukoy na dokumentong uri.
createDocumentType() Nagpalilipat ng walang laman na DocumentType node.
getFeature() Nagpalilipat ng object na naglalaman ng API na nagpatupad ng tinukoy na katangian at bersyon (kung mayroon).
hasFeature() Tiningnan kung ang DOM implementation ay nagpatupad ng espesyal na katangian at bersyon.

Katangian ng ProcessingInstruction object

Ang ProcessingInstruction object ay naglalarawan ng prosesong ito.

Ang prosesong ito ay ginagamit bilang paraan upang mapanatili ang espesyal na impormasyon ng processor sa teksto ng XML dokumento.

Atribute 描述
data Iset o nagpalilipat ng nilalaman ng prosesong ito.
target Nagpalilipat ng layunin ng prosesong ito.

Top

XML DOM Element 對象

Katangian ng Element object

Atribute 描述
attributes Nagpalilipat ng mga katangian ng elementong ginamit ang NamedNodeMap.
baseURI Nagbibigay ng absolute base URI ng elemento.
childNodes Nagbibigay ng NodeList ng mga anak na node ng elemento.
firstChild Nagbibigay ng unang anak na elemento ng elemento.
lastChild Nagbibigay ng huling anak na elemento ng elemento.
localName Nagbibigay ng lokal na bahagi ng pangalan ng elemento.
namespaceURI Nagbibigay ng URI ng namespace ng elemento.
nextSibling Nagbibigay ng elemento na sumusunod sa tinukoy na elemento.
nodeName Nagbibigay ng pangalan ng node, depende sa kaniyang uri.
nodeType Ibalik ang uri ng uri ng node.
ownerDocument Nagbibigay ng root element ng node (dokumentong object).
parentNode Nagbibigay ng magulang na elemento ng elemento.
prefix Mag-set o magbibigay ng prefix ng namespace ng elemento.
previousSibling Nagbibigay ng elemento na kasunod sa tinukoy na elemento.
schemaTypeInfo Nagbibigay ng impormasyon ng uri ng elemento na nauugnay sa kaniyang katangian.
tagName Nagbibigay ng pangalan ng elemento.
textContent Mag-set o magbibigay ng teksto ng elemento at lahat ng kaniyang mga hila.

Method ng Element object

Paraan 描述
appendChild() Magdagdag ng bagong anak na node sa huling dulo ng listahan ng mga anak ng elemento.
cloneNode() Pagkopya ng node.
compareDocumentPosition() Paghahambing ng posisyon ng dalawang node sa dokumento.
getAttribute() Nagbibigay ng halaga ng attribute.
getAttributeNS() Nagbibigay ng halaga ng attribute na may namespace.
getAttributeNode() Nagbibigay ng attribute na node, bilang isang Attribute object.
getAttributeNodeNS() Nagbibigay ng attribute na node na may namespace, bilang isang Attribute object.
getElementsByTagName() Nagbibigay ng NodeList ng tumugma na elemento na node at lahat ng kaniyang mga anak.
getElementsByTagNameNS() Nagbibigay ng NodeList ng tumugma na elemento na node at lahat ng kaniyang mga anak na may namespace.
getFeature(feature,version) Nagbibigay ng DOM object na naglalapat ng natukoy na katangian at bersyon na专用 API.
getUserData(key) Nagbibigay ng object na nauugnay sa key ng node. Dapat ma-set ang object sa node muna, sa pamamagitan ng paggamit ng parehong key para sa pagtawag sa setUserData.
hasAttribute() Nagbibigay kung ang elemento ay may attribute na tumutugma sa tinukoy na pangalan.
hasAttributeNS() Nagbibigay kung ang elemento ay may attribute na tumutugma sa tinukoy na pangalan at namespace.
hasAttributes() Nagbibigay kung ang elemento ay may mga attribute.
hasChildNodes() Nagbibigay kung ang elemento ay may mga anak na elemento.
insertBefore() Idagdag ang bagong anak na kasalukuyan bago ang kasalukuyang mga anak na kasalukuyan.
isDefaultNamespace(URI) Ibinalik kung ang tinukoy na namespaceURI ay default.
isEqualNode() Suriin kung ang dalawang node ay katulad.
lookupNamespaceURI() Ibinalik ang namespace URI na tumutugma sa tinukoy na pangalan ng prefix.
lookupPrefix() Ibinalik ang pangalan ng prefix na tumutugma sa tinukoy na namespace URI.
normalize()

Ang normalize() method ay alisin ang walang laman na text node at pinagsama-sama ang magkakasunod na text node.

Iregularize ang lahat ng text node sa ilalim ng elemento (kasama ang mga attribute), kung saan tanging ang kaayusan (hal. elemento, comment, directive, CDATA section at entity reference) ay pinaghihiwalay ang mga text node.

Kaya, walang magkakasunod na text node at walang walang laman na text node.

removeAttribute() Tanggalin ang tinukoy na pagpapamahalan.
removeAttributeNS() Tanggalin ang tinukoy na pagpapamahalan (may namespace).
removeAttributeNode() Tanggalin ang tinukoy na node ng pagpapamahalan.
removeChild() Tanggalin ang anak na kasalukuyan.
replaceChild() Palitan ang mga anak na kasalukuyan.
setUserData(key,data,handler) Ihahalan ang bagay sa kinaugalian ng pangkayong-bahay sa elemento.
setAttribute() Magdagdag ng bagong pagpapamahalan.
setAttributeNS() Magdagdag ng bagong pagpapamahalan (may namespace).
setAttributeNode() Magdagdag ng bagong node ng pagpapamahalan.
setAttributeNodeNS(attrnode) Magdagdag ng bagong node ng pagpapamahalan (may namespace).
setIdAttribute(name,isId) Kung ang isId attribute ng Attribute object ay totoo, ang paraan na ito ay nagdeklara ng itinalagang ID attribute ng user sa tinukoy na pagpapamahalan.
setIdAttributeNS(uri,name,isId) Kung ang isId attribute ng Attribute object ay totoo, ang paraan na ito ay nagdeklara ng tinukoy na pagpapamahalan (may namespace) bilang itinalagang ID attribute ng user.
setIdAttributeNode(idAttr,isId) Kung ang isId attribute ng Attribute object ay totoo, ang paraan na ito ay nagdeklara ng itinalagang ID attribute ng user sa tinukoy na pagpapamahalan.

Top

Atribute ng Attr object

Atribute 描述
baseURI Ibinalik ang wakas na base URI ng pagpapamahalan.
isId Kung ang pagpapamahalan ay uri ng id, ibinalik ang totoo, kung hindi ibinalik ang maliit na totoo.
localName Ibinalik ang lokal na bahagi ng pangalan ng pagpapamahalan.
name Ibinalik ang pangalan ng pagpapamahalan.
namespaceURI Ibinalik ang namespace URI ng pagpapamahalan.
nodeName Ibalik ang pangalan ng node, ayon sa uri nito.
nodeType Ibalik ang uri ng uri ng node.
nodeValue Itatalaga o ihatid ang halaga ng node, ayon sa uri nito.
ownerDocument Ibalik ang pangunahing elemento (dokumentong object).
ownerElement Ibalik ang elemento na kaugnay ng katangian.
prefix Itatalaga o ihatid ang pangalan ng namespace na kaugnay ng katangian.
schemaTypeInfo Ibalik ang impormasyon ng uri ng uri ng katangian na kaugnay dito.
specified

Kung ang halaga ng katangian ay inilagay sa dokumento, ibalik ang true;

Kung ang halaga ng katangian ay default sa DTD/Schema, ibalik ang false.

textContent Itatalaga o ihatid ang teksto ng nilalaman ng katangian.
value Itatalaga o ihatid ang halaga ng katangian.

Top

XML DOM Text 對象

Mga katangian ng Text object.

Atribute 描述
data Itatalaga o ihatid ang teksto ng elemento o katangian.
isElementContentWhitespace Hilingin kung ang text node ay naglalaman ng puti na karakter na nilalaman.
length Ihatid ang haba ng teksto ng elemento o katangian.
wholeText Ihatid ang lahat ng teksto ng katabi na text node na teksto, na nakakabit sa order ng dokumento.

Mga paraan ng Text object.

Paraan 描述
appendData() Idagdag ang data sa huli sa node.
deleteData() Ihatid ang data mula sa node.
insertData() Iinsert ang data sa loob ng node.
replaceData() Palitan ang data sa loob ng node.
replaceWholeText(text) Palitan ang buong teksto ng node at lahat ng katabi nitong text node na teksto gamit ang tinukoy na teksto.
splitText() Hatiin ang Text node sa dalawang.
substringData() Hikayatin ang data mula sa node.

Top

XML DOM CDATASection 對象

Mga katangian ng CDATASection object.

Atribute 描述
data Itatalaga o ihatid ang teksto ng node.
length Ihatid ang haba ng CDATA na bahagi.

Mga paraan ng CDATASection object.

Paraan 描述
appendData() Idagdag ang data sa huli sa node.
deleteData() Ihatid ang data mula sa node.
insertData() Iinsert ang data sa loob ng node.
replaceData() Palitan ang data sa loob ng node.
splitText() Hatiin ang CDATA node sa dalawang node.
substringData() Hikayatin ang data mula sa node.

Top

XML DOM Comment 對象

Mga katangian ng Comment object.

Atribute 描述
data Itatalaga o ihatid ang teksto ng node.
length Ihatid ang haba ng teksto ng node.

Mga paraan ng Comment object.

Paraan 描述
appendData() Idagdag ang data sa huli sa node.
deleteData() Ihatid ang data mula sa node.
insertData() Iinsert ang data sa loob ng node.
replaceData() Palitan ang data sa loob ng node.
substringData() Hikayatin ang data mula sa node.

Top

XML DOM XMLHttpRequest 對象

Mga paraan ng XMLHttpRequest object.

Paraan 描述
abort() Ikansela ang kasalukuyang kahilingan.
getAllResponseHeaders() Ihatid ang impormasyon ng header.
getResponseHeader() Ihatid ang halaga ng pinagmulan ng HTTP na tugon na pinagmulan ang pinagmulan ng tugon na header.
open(method,url,async,uname,pswd)

Tukuyin ang uri ng kahilingan, ang URL, kung dapat iasynchronous ang paghiling ng kahilingan at ibang opsyonal na katangian ng kahilingan.

  • method: Uri ng kahilingan: GET o POST
  • url: Lokasyon ng file sa server
  • async: true (asynchronous) o false (synchronous)
send(string)

I-send ang kahilingan sa server.

string: Gagamitin lamang sa kahilingan na POST

setRequestHeader() Magdagdag ng pariralang tag/halaga sa header na idadala.

Atribute ng XMLHttpRequest object

Atribute 描述
onreadystatechange I-store ang function (o pangalan ng function) na awtomatikong tinatawag bawat pagbabago sa readyState property.
readyState

I-save ang estado ng XMLHttpRequest. Mga pagbabago mula 0 hanggang 4:

  • 0: Hindi nainitialis ang kahilingan
  • 1: Naitatag ang koneksyon sa server
  • 2: Nakatanggap ang kahilingan
  • 3: Ginagawa ang kahilingan
  • 4: Nagtapos na ang kahilingan, ang tugon ay handa na
responseText Ibalik ang datos ng tugon, bilang string.
responseXML Ibalik ang datos ng tugon, bilang datos ng XML.
status Ibalik ang numero ng estado (halimbawa, "404" para sa "Not Found", o "200" para sa "OK").
statusText Ibalik ang teksto ng estado (halimbawa, "Not Found" o "OK").

Top

Elemento ng XSD

element Ipaliwanag
all Tumutukoy na ang mga pangalawang elemento ay maaaring lumabas sa anumang pagkakasunod-sunod, at ang bawat pangalawang elemento ay maaaring lumabas nang dalawa o wala.
annotation Ang elemento ng annotation ay isang pang-unang-bahagi na tumutukoy sa puna ng schema.
any Payagan ang tagapaglikha na magpalawak ng XML dokumento sa pamamagitan ng mga elemento na hindi tinukoy ng schema.
anyAttribute Payagan ang tagapaglikha na magpalawak ng XML dokumento sa pamamagitan ng mga attribute na hindi tinukoy ng schema.
appInfo Tukuyin ang impormasyon na gagamitin ng aplikasyon sa elemento ng annotation.
attribute Tukuyin ang isang attribute.
attributeGroup Tukuyin ang pangkat ng attribute na ginamit sa paglalarawan ng kumplikadong uri.
choice Pinapayagan lamang ang isang elemento na lumalabas sa nakakabit na elemento sa paglalarawan ng <choice>.
complexContent Tukuyin ang pagpapasadya o pagbabawas sa kumplikadong uri (nakakabit ng mixed content o naglalaman lamang ng mga elemento).
complexType Tukuyin ang kumplikadong uri.
documentation Tukuyin ang teksto ng puna sa schema.
element Tukuyin ang elemento.
extension Ekspandin ang mayroon pang simpleType o complexType na elemento.
field 规定 XPath 表达式,该表达式规定用于定义标识约束的值。
group 定义在复杂类型定义中使用的元素组。
import 向一个文档添加带有不同目标命名空间的多个 schema。
include 向一个文档添加带有相同目标命名空间的多个 schema。
key 指定属性或元素值(或一组值)必须是指定范围内的键。
keyref 规定属性或元素值(或一组值)对应指定的 key 或 unique 元素的值。
list 把简单类型定义为指定数据类型的值的一个列表。
notation 描述 XML 文档中非 XML 数据的格式。
redefine 重新定义从外部架构文件中获取的简单和复杂类型、组和属性组。
restriction 定义对 simpleType、simpleContent 或 complexContent 的约束。
schema 定义 schema 的根元素。
selector 指定 XPath 表达式,该表达式为标识约束选择一组元素。
sequence 要求子元素必须按顺序出现。每个子元素可出现 0 到任意次数。
simpleContent 包含对 complexType 元素的扩展或限制且不包含任何元素。
simpleType 定义一个简单类型,规定约束以及关于属性或仅含文本的元素的值的信息。
union 定义多个 simpleType 定义的集合。
unique 指定属性或元素值(或者属性或元素值的组合)在指定范围内必须是唯一的。

对数据类型的 XSD 限定

参阅 XSD 限定 / Facets

限定 描述
enumeration 定义可接受值的一个列表
fractionDigits 定义所允许的最大的小数位数。必须大于等于0。
length 定义所允许的字符或者列表项目的精确数目。必须大于或等于0。
maxExclusive 定义数值的上限。所允许的值必须小于此值。
maxInclusive 定义数值的上限。所允许的值必须小于或等于此值。
maxLength 定义所允许的字符或者列表项目的最大数目。必须大于或等于0。
minExclusive 定义数值的下限。所允许的值必需大于此值。
minInclusive 定义数值的下限。所允许的值必需大于或等于此值。
minLength 定义所允许的字符或者列表项目的最小数目。必须大于或等于0。
pattern 定义可接受的字符的精确序列。
totalDigits 定义所允许的阿拉伯数字的精确位数。必须大于0。
whiteSpace 定义空白字符(换行、回车、空格以及制表符)的处理方式。

Top

XSLT 元素

element 描述
apply-imports 应用来自导入样式表中的模版规则。
apply-templates 向当前元素或当前元素的子元素应用模板。
attribute 向元素添加属性。
attribute-set 创建命名的属性集。
call-template 调用一个指定的模板。
choose 与<when>以及<otherwise>协同使用,来表达多重条件测试。
comment 在结果树中创建注释节点。
copy 创建当前节点的一个备份(无子节点及属性)。
copy-of 创建当前节点的一个备份(带有子节点及属性)。
decimal-format 定义当通过 format-number() 函数把数字转换为字符串时,所要使用的字符和符号。
element 在输出文档中创建一个元素节点。
fallback 假如处理器不支持某个XSLT元素,规定一段备用代码来运行。
for-each 遍历指定的节点集中的每个节点。
if 包含一个模板,仅当某个指定的条件成立时应用此模板。
import 用于把一个样式表中的内容倒入另一个样式表中。
include 把一个样式表中的内容包含到另一个样式表中。
key 声明一个命名的键。
message 向输出写一条消息(用于错误报告)。
namespace-alias 把样式表中的命名空间替换为输出中不同的命名空间。
number 测定当前节点的整数位置,并对数字进行格式化。
otherwise 规定 <choose> 元素的默认动作。
output 定义输出文档的格式。
param 声明一个局部或全局参数。
preserve-space 用于定义保留空白的元素。
processing-instruction 生成处理指令节点。
sort 对结果进行排序。
strip-space 定义应当删除空白字符的元素。
stylesheet يحدد عنصر جذر القالب.
template القواعد التي تطبقها عند مطابقة العنصر المحدد.
text يولد عناصر نصية من خلال القالب.
transform يحدد عنصر جذر القالب.
value-of يستعيد القيمة من العنصر المحدد.
variable يحدد المتغيرات المحلية أو العالمية.
when يحدد الفعل للمكون <choose>.
with-param يحدد القيمة المطلوبة لتوصيلها إلى قالب معين.

Top

XSLT、XPath 以及 XQuery 函數

وظائف الوصول

名称 说明
fn:node-name(node) يستعيد اسم العنصر للمعامل.
fn:nilled(node) يستعيد القيمة الحالية للمعامل كقيمة منطقية.
fn:data(item.item,...) يتقبل سلسلة من العناصر ويستعيد سلسلة من القيم الذرية.
  • fn:base-uri()
  • fn:base-uri(node)
يستعيد قيمة سمة base-uri للعنصر الحالي أو المحدد.
fn:document-uri(node) يستعيد قيمة سمة document-uri للعنصر المحدد.

وظائف الأخطاء والتعقب

名称 说明
  • fn:error()
  • fn:error(error)
  • fn:error(error,description)
  • fn:error(error,description,error-object)

الامثلة: error(fn:QName('http://example.com/test', 'err:toohigh'), 'Error: Price is too high')

النتيجة: عودة http://example.com/test#toohigh إلى البيئة المعالجة الخارجية مع الكلمة

fn:trace(value,label) لتحليل اختبار الاستعلام.

وظائف العدد

名称 说明
fn:number(arg)

يستعيد القيمة العددية للمعامل. يمكن أن يكون المعامل قيمة منطقية أو نصية أو مجموعة من العناصر.

الامثلة: number('100')

النتيجة: 100

fn:abs(num)

يستعيد القيمة المطلقة للمعامل.

الامثلة: abs(3.14)

النتيجة: 3.14

الامثلة: abs(-3.14)

النتيجة: 3.14

fn:ceiling(num)

يستعيد أكبر عدد صحيح أكبر من معامل num.

الامثلة: ceiling(3.14)

结果:4

fn:floor(num)

Binabalik ang pinakamalalaki na integer na hindi hihigit sa num parameter.

Halimbawa:floor(3.14)

结果:3

fn:round(num)

Ihahaliling ang num parameter sa pinakamalapit na integer.

Halimbawa:round(3.14)

结果:3

fn:round-half-to-even()

Halimbawa:round-half-to-even(0.5)

结果:0

Halimbawa:round-half-to-even(1.5)

结果:2

Halimbawa:round-half-to-even(2.5)

结果:2

Mga function tungkol sa string

名称 说明
fn:string(arg)

Binabalik ang string value ng argumento. Ang argumento ay maaaring maging numero, logical value o node set.

Halimbawa:string(314)

结果:"314"

fn:codepoints-to-string(int,int,...)

Binabalik ang string ng codepoint sequence.

Halimbawa:codepoints-to-string(84, 104, 233, 114, 232, 115, 101)

结果:'Thérèse'

fn:string-to-codepoints(string)

Binabalik ang codepoint sequence ng string.

Halimbawa:string-to-codepoints("Thérèse")

结果:84, 104, 233, 114, 232, 115, 101

fn:codepoint-equal(comp1,comp2) Ayon sa Unicode codepoint collation, kung ang halaga ng comp1 ay katumbas ng halaga ng comp2, ibabalik ang true. (http://www.w3.org/2005/02/xpath-functions/collation/codepoint), kung hindi ibabalik ang false。
  • fn:compare(comp1,comp2)
  • fn:compare(comp1,comp2,collation)

Kung ang comp1 ay mas mababa sa comp2, ibabalik ang -1. Kung ang comp1 ay katumbas ng comp2, ibabalik ang 0. Kung ang comp1 ay mas malaki sa comp2, ibabalik ang 1.(Ayon sa ginamit na panlabas na patakaran)。

Halimbawa:compare('ghi', 'ghi')

结果:0

fn:concat(string,string,...)

Binabalik ang pagsasamahin ng string.

Halimbawa:concat('XPath ','ay ','FUN!')

结果:'XPath ay FUN!}

fn:katipunin ang mga string ((string, string,...),sep)

使用 sep 参数作为分隔符,来返回 string 参数拼接后的字符串。

例子:string-join(('We', 'are', 'having', 'fun!'), ' ')

结果:' We are having fun! '

例子:string-join(('We', 'are', 'having', 'fun!'))

结果:'Wearehavingfun!'

例子:string-join((), 'sep')

结果:''

  • fn:substring(string,start,len)
  • fn:substring(string,start)

返回从 start 位置开始的指定长度的子字符串。第一个字符的下标是 1。如果省略 len 参数,则返回从位置 start 到字符串末尾的子字符串。

例子:substring('Beatles',1,4)

结果:'Beat'

例子:substring('Beatles',2)

结果:'eatles'

  • fn:string-length(string)
  • fn:string-length()

返回指定字符串的长度。如果没有 string 参数,则返回当前节点的字符串值的长度。

例子:string-length('Beatles')

结果:7

  • fn:normalize-space(string)
  • fn:normalize-space()

删除指定字符串的开头和结尾的空白,并把内部的所有空白序列替换为一个,然后返回结果。如果没有 string 参数,则处理当前节点。

例子:normalize-space(' The   XML ')

结果:'The XML'

fn:normalize-unicode() 执行 Unicode 规格化。
fn:upper-case(string)

把 string 参数转换为大写。

例子:upper-case('The XML')

结果:'THE XML'

fn:lower-case(string)

把 string 参数转换为小写。

例子:lower-case('The XML')

结果:'ang xml'

fn:translate(string1,string2,string3)

Palitan ang string2 sa string1 ng string3.

Halimbawa: translate('12:30','30','45')

Resulta: '12:45'

Halimbawa: translate('12:30','03','54')

Resulta: '12:45'

Halimbawa: translate('12:30','0123','abcd')

Resulta: 'bc:da'

fn:escape-uri(stringURI,esc-res)

Halimbawa: escape-uri("http://example.com/test#car", true())

Resulta: "http%3A%2F%2Fexample.com%2Ftest#car"

Halimbawa: escape-uri("http://example.com/test#car", false())

Resulta: "http://example.com/test#car"

Halimbawa: escape-uri ("http://example.com/~bébé", false())

Resulta: "http://example.com/~b%C3%A9b%C3%A9"

fn:contains(string1,string2)

Kung ang string1 ay naglalaman ng string2, ibalik ang true, kung hindi ibalik ang false.

Halimbawa: contains('XML','XM')

Mga resulta: true

fn:starts-with(string1,string2)

Kung ang string1 ay nagsisimula sa string2, ibalik ang true, kung hindi ibalik ang false.

Halimbawa: starts-with('XML','X')

Mga resulta: true

fn:ends-with(string1,string2)

Kung ang string1 ay nagtatapos sa string2, ibalik ang true, kung hindi ibalik ang false.

Halimbawa: ends-with('XML','X')

Resulta: false

fn:substring-before(string1,string2)

Bumalik ang string2 sa bago na sub-string sa string1.

Halimbawa: substring-before('12/10','/')

Resulta: '12'

fn:substring-after(string1,string2)

Bumalik ang string2 sa susunod na sub-string sa string1.

Halimbawa: substring-after('12/10','/')

Mga resulta: '10'

fn:matches(string,pattern)

Kung ang string na argumento ay tumutugma sa tinukoy na pattern, ibalik ang true, kung hindi, ibalik ang false.

Halimbawa: matches("Merano", "ran")

Mga resulta: true

fn:replace(string,pattern,replace)

Palitan ang tinukoy na pattern ng replace parameter at ibalik ang resulta.

Halimbawa: replace("Bella Italia", "l", "*")

Mga resulta: 'Be**a Ita*ia'

Halimbawa: replace("Bella Italia", "l", "")

Mga resulta: 'Bea Itaia'

fn:tokenize(string,pattern)

Halimbawa: tokenize("XPath is fun", "\s+")

Mga resulta: ("XPath", "is", "fun")

Mga function na may kaugnayan sa anyURI

名称 说明
fn:resolve-uri(relative,base)  

Mga function tungkol sa boolean

名称 说明
fn:boolean(arg) Bumalik ang boolean na may halaga ng number, string o node set.
fn:not(arg)

Una, ibalik ang argumento sa boolean na may halaga sa pamamagitan ng function na boolean()

Kung ang boolean na ito ay false, bumalik ang true, kung hindi, bumalik ang true.

Halimbawa: not(true())

Resulta: false

fn:true()

Bumalik ang boolean na may halaga na true.

Halimbawa: true()

Mga resulta: true

fn:false()

Bumalik ang boolean na may halaga na false.

Halimbawa: false()

Resulta: false

Mga function tungkol sa tagal ng panahon, petsa at oras

Mga function na kumukuha ng bahagi ng petsa, oras at tagal ng panahon

名称 说明
fn:dateTime(date,time) Ibaguhin ang argumento sa petsa at oras.
fn:years-from-duration(datetimedur) Bumalik ang taon ng argumento bilang integer, na inilalarawan sa standard na paraan ng paglalarawan ng wika.
fn:months-from-duration(datetimedur) Bumalik ang buwan ng argumento bilang integer, na inilalarawan sa standard na paraan ng paglalarawan ng wika.
fn:days-from-duration(datetimedur) Bumalik ang buwan ng argumento bilang integer, na inilalarawan sa standard na paraan ng paglalarawan ng wika.
fn:hours-from-duration(datetimedur) Bumalik ang halaga ng argumento bilang integer na nagsasagawa ng oras, na inilalarawan sa pamamagitan ng standard na wika ng paglalarawan.
fn:minutes-from-duration(datetimedur) Bumalik ang halaga ng argumento bilang integer na nagsasagawa ng minuto, na inilalarawan sa pamamagitan ng standard na wika ng paglalarawan.
fn:seconds-from-duration(datetimedur) Bumalik ang halaga ng argumento bilang decimal na nagsasagawa ng minuto, na inilalarawan sa pamamagitan ng standard na wika ng paglalarawan.
fn:year-from-dateTime(datetime)

Bumalik ang lokal na halaga ng argumento bilang integer na nagsasagawa ng taon.

Halimbawa: year-from-dateTime(xs:dateTime("2005-01-10T12:30-04:10"))

结果:2005

fn:month-from-dateTime(datetime)

Bumalik ang lokal na halaga ng argumento bilang integer na nagsasagawa ng buwan.

Halimbawa: month-from-dateTime(xs:dateTime("2005-01-10T12:30-04:10"))

Resulta: 01

fn:day-from-dateTime(datetime)

Bumalik ang lokal na halaga ng argumento bilang integer na nagsasagawa ng araw.

Halimbawa: day-from-dateTime(xs:dateTime("2005-01-10T12:30-04:10"))

结果:10

fn:hours-from-dateTime(datetime)

Bumalik ang lokal na halaga ng argumento bilang integer na nagsasagawa ng oras.

Halimbawa: hours-from-dateTime(xs:dateTime("2005-01-10T12:30-04:10"))

Resulta: 12

fn:minutes-from-dateTime(datetime)

Bumalik ang lokal na halaga ng argumento bilang integer na nagsasagawa ng minuto.

Halimbawa: minutes-from-dateTime(xs:dateTime("2005-01-10T12:30-04:10"))

Resulta: 30

fn:seconds-from-dateTime(datetime)

Bumalik ang lokal na halaga ng argumento bilang decimal na nagsasagawa ng segundo.

Halimbawa: seconds-from-dateTime(xs:dateTime("2005-01-10T12:30:00-04:10"))

结果:0

fn:timezone-from-dateTime(datetime) 返回参数的时区部分,如果存在。
fn:year-from-date(date)

Bumalik ang lokal na halaga ng argumento bilang integer na naglalaro ng taon.

Halimbawa: year-from-date(xs:date("2005-04-23"))

结果:2005

fn:month-from-date(date)

返回参数本地值中表示月的整数。

例子:month-from-date(xs:date("2005-04-23"))

结果:4

fn:day-from-date(date)

返回参数本地值中表示天的整数。

例子:day-from-date(xs:date("2005-04-23"))

结果:23

fn:timezone-from-date(date) 返回参数的时区部分,如果存在。
fn:hours-from-time(time)

返回参数本地值中表示小时部分的整数。

例子:hours-from-time(xs:time("10:22:00"))

结果:10

fn:minutes-from-time(time)

返回参数本地值中表示分钟部分的整数。

例子:minutes-from-time(xs:time("10:22:00"))

结果:22

fn:seconds-from-time(time)

返回参数本地值中表示秒部分的整数。

例子:seconds-from-time(xs:time("10:22:00"))

结果:0

fn:timezone-from-time(time) 返回参数的时区部分,如果存在。
fn:adjust-dateTime-to-timezone(datetime,timezone)

如果 timezone 参数为空,则返回没有时区的 dateTime。

否则返回带有时区的 dateTime。

fn:adjust-date-to-timezone(date,timezone)

如果 timezone 参数为空,则返回没有时区的 date。

否则返回带有时区的 date。

fn:adjust-time-to-timezone(time,timezone)

如果 timezone 参数为空,则返回没有时区的 time。

否则返回带有时区的 time。

与 QNames 相关的函数

名称 说明
fn:QName()  
fn:local-name-from-QName()  
fn:namespace-uri-from-QName()  
fn:namespace-uri-for-prefix()  
fn:in-scope-prefixes()  
fn:resolve-QName()  

Function tungkol sa node

名称 说明
  • fn:name()
  • fn:name(nodeset)
Ibalik ang pangalan ng kasalukuyang node o unang node ng tinukoy na set ng node.
  • fn:local-name()
  • fn:local-name(nodeset)
Ibalik ang pangalan ng kasalukuyang node o unang node ng tinukoy na set ng node - walang prefiksang namespace.
  • fn:namespace-uri()
  • fn:namespace-uri(nodeset)
Ibalik ang namespace URI ng unang node ng kasalukuyang node o tinukoy na set ng node.
fn:lang(lang)

Ibalik ang true kung ang wika ng kasalukuyang node ay katumbas ng tinukoy na wika.

Halimbawa: Lang("en") ay true para sa <p xml:lang="en">...</p>

Halimbawa: Lang("de") ay false para sa <p xml:lang="en">...</p>

  • fn:root()
  • fn:root(node)
Ibalik ang pinagmulang node ng puno ng node na kasama ang kasalukuyang node o tinukoy na node. Kalimitan ang dokumentong node.

Function tungkol sa serye

Umamahin na function

名称 说明
fn:index-of((item,item,...),searchitem)

Ibalik ang posisyon ng proyekta sa serye ng item na katumbas ng argumento na searchitem.

Halimbawa: index-of ((15, 40, 25, 40, 10), 40)

Resulta: (2, 4)

Halimbawa: index-of (("a", "dog", "and", "a", "duck"), "a")

Resulta (1, 4)

Halimbawa: index-of ((15, 40, 25, 40, 10), 18)

Resulta: ()

fn:remove((item,item,...),position)

Ibalik ang bagong serye na binuo ng argumento na item - habang inaalis ang proyekta na tinukoy ng argumento na position.

Halimbawa: remove(("ab", "cd", "ef"), 0)

Resulta: ("ab", "cd", "ef")

Halimbawa: remove(("ab", "cd", "ef"), 1)

Resulta: ("cd", "ef")

Halimbawa: remove(("ab", "cd", "ef"), 4)

Resulta: ("ab", "cd", "ef")

fn:empty(item,item,...)

Kung ang halaga ng argumento ay walang hirap na serye, ibabalik ang true, kung hindi ibabalik ang false.

Halimbawa: empty(remove(("ab", "cd"), 1))

Resulta: false

fn:exists(item,item,...)

Kung ang halaga ng parameter ay hindi walang laman na sequence, bumalik true, kung hindi bumalik false.

Halimbawa: exists(remove(("ab"), 1))

Resulta: false

fn:distinct-values((item,item,...),collation)

Bumalik sa mga nag-iisang magkakaiba na halaga.

Halimbawa: distinct-values((1, 2, 3, 1, 2))

Resulta: (1, 2, 3)

fn:insert-before((item,item,...),pos,inserts)

Bumalik sa bagong sequence na binuo ng item parameter - kasama na ang pagipasok ng halaga ng inserts parameter sa posisyon na tinukoy ng pos parameter.

Halimbawa: insert-before(("ab", "cd"), 0, "gh")

Resulta: ("gh", "ab", "cd")

Halimbawa: insert-before(("ab", "cd"), 1, "gh")

Resulta: ("gh", "ab", "cd")

Halimbawa: insert-before(("ab", "cd"), 2, "gh")

Resulta: ("ab", "gh", "cd")

Halimbawa: insert-before(("ab", "cd"), 5, "gh")

Resulta: ("ab", "cd", "gh")

fn:reverse((item,item,...))

Bumalik sa bawat kahit anong ordey ng tinukoy na item.

Halimbawa: reverse(("ab", "cd", "ef"))

Resulta: ("ef", "cd", "ab")

Halimbawa: reverse(("ab"))

Resulta: ("ab")

fn:subsequence((item,item,...),start,len)

Bumalik sa posisyon na tinukoy ng start parameter ang item sequence, ang haba ng sequence ay tinukoy ng len parameter.

Ang posisyon ng unang item ay 1.

Halimbawa: subsequence(($item1, $item2, $item3,...), 3)

Resulta: ($item3, ...)

Halimbawa: subsequence(($item1, $item2, $item3, ...), 2, 2)

Resulta: ($item2, $item3)

fn:unordered((item,item,...)) Bumalik sa ordey na tinutukoy ng pagpapatupad.

Test ang kapasidad ng sequence

名称 说明
fn:zero-or-one(item,item,...) 如果参数包含零个或一个项目,则返回参数,否则生成错误。
fn:one-or-more(item,item,...) 如果参数包含一个或多个项目,则返回参数,否则生成错误。
fn:exactly-one(item,item,...) 如果参数包含一个项目,则返回参数,否则生成错误。

Equals, Union, Intersection and Except

名称 说明
fn:deep-equal(param1,param2,collation) 如果 param1 和 param2 与彼此相等(deep-equal),则返回 true,否则返回 false。

合计函数

名称 说明
fn:count((item,item,...)) 返回节点的数量。
fn:avg((arg,arg,...))

返回参数值的平均数。

例子:avg((1,2,3))

结果:2

fn:max((arg,arg,...))

返回大于其它参数的参数。

例子:max((1,2,3))

结果:3

例子:max(('a', 'k'))

结果:'k'

fn:min((arg,arg,...))

返回小于其它参数的参数。

例子:min((1,2,3))

结果:1

例子:min(('a', 'k'))

结果:'a'

fn:sum(arg,arg,...) 返回指定节点集中每个节点的数值的总和。

生成序列的函数

名称 说明
fn:id((string,string,...),node) 返回元素节点序列,这些节点的 ID 值等于 string 参数中指定的一个或多个值。
fn:idref((string,string,...),node) 返回元素或属性节点序列,这些节点的 IDREF 值等于 string 参数中指定的一个或多个值。
fn:doc(URI)  
fn:doc-available(URI) 如果 doc() 函数返回文档节点,则返回 true,否则返回 false。
  • fn:collection()
  • fn:collection(string)
 

上下文函数

名称 说明
fn:position()

返回当前正在被处理的节点的 index 位置。

例子://book[position()<=3]

结果:选择前三个 book 元素

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。

Top

其他 XML DOM 对象

Top