XML referans el kitabı

XML referans el kitabı

Düğüm türü

Aşağıdaki tablo, farklı W3C düğüm türlerini ve sahip olabilecekleri alt elementleri gösterir:

Düğüm türü Tanım Alt element
Document Tüm belgeyi (DOM ağacının kök düğümü) temsil eder.
  • Element (max. bir)
  • ProcessingInstruction
  • Yorum
  • DocumentType
DocumentFragment Belgeyi içeren hafif bir Document nesnesi temsil eder.
  • ProcessingInstruction
  • Yorum
  • Text
  • CDATASection
  • EntityReference
DocumentType Belge için tanımlanan sembollere erişim sağlar. None
ProcessingInstruction İşleme talimatını temsil eder. None
EntityReference Bağlantılı referans elementini temsil eder.
  • ProcessingInstruction
  • Yorum
  • Text
  • CDATASection
  • EntityReference
Element Element (element) elementini temsil eder.
  • Text
  • Yorum
  • ProcessingInstruction
  • CDATASection
  • EntityReference
Attr Özellikleri temsil eder.
  • Text
  • EntityReference
Text Element veya özellikteki metin içeriğini temsil eder. None
CDATASection İşleyici tarafından çözümlenmeyen metni temsil eder. None
Yorum Yorumları temsil eder. None
Varlık Sembolleri temsil eder.
  • ProcessingInstruction
  • Yorum
  • Text
  • CDATASection
  • EntityReference
Notasyon DTD'de tanımlanan sembolleri temsil eder. None

Düğüm türü - Döndürülen değer

Aşağıdaki tablo, her düğüm türü için nodeName ve nodeValue özelliklerinin dönebileceği değerleri gösterir:

Düğüm türü nodeName'nun döndürdüğü değer nodeValue'nun döndürdüğü değer
Document #document null
DocumentFragment #document fragment null
DocumentType doctype adı null
EntityReference Bağlantılı referans adı null
Element element adı null
Attr Özellik adı Özellik değeri
ProcessingInstruction target Düğüm içeriği
Yorum #comment Yorum metni
Text #text Düğüm içeriği
CDATASection #cdata-section Düğüm içeriği
Varlık Varlık adı null
Notasyon Sembol adı null

NodeTypes - Adlı sabitler

NodeType Adlı sabit
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 nesnesi

Node nesnesi özellikleri

Özellik Tanım
attributes Bu düğümün özelliklerini içeren NamedNodeMap (bu düğüm bir element ise).
baseURI Düğümün mutlak temel URI'yi döndürür.
childNodes Düğümün alt düğümlerinin NodeList'ini döndürür.
firstChild Düğümün ilk alt düğümünü döndürür.
lastChild Düğümün son alt düğümünü döndürür.
nextSibling Düğümün sonraki yakınlaştırılmış同级 düğümünü döndürür.
nodeName 返回节点的名称,根据其类型。
nodeType 返回节点的类型。
nodeValue 设置或返回节点的值,根据其类型。
ownerDocument Düğümün kök elementini (document nesnesi) döndürür.
parentNode Düğümün ana düğümünü döndürür.
prefix Düğümün ad alanı önekiyi ayarlar veya döndürür.
previousSibling Düğümün önceki yakınlaştırılmış同级 düğümünü döndürür.
textContent Düğümün ve soyunun metin içeriğini ayarlar veya döndürür.

Node nesnesi yöntemleri

方法 Tanım
appendChild() Yeni alt düğümü düğümün alt düğüm listesinin sonuna ekler.
cloneNode() Nodu klonlar.
compareDocumentPosition() DOM hiyerarşisi (belge) içinde iki düğümün konumunu karşılaştırır.
getFeature(feature,version) Belirtilen özellik ve sürümle özel API'yi gerçekleştiren DOM nesnesini döndürür.
getUserData(key)

Düğümdeki anahtara bağlanan nesneyi döndürür.

Öncelikle nesneyi bu düğüme ayarlamak gerekir, setUserData ile aynı anahtarı çağırarak.

hasAttributes() Belirtilen düğümde herhangi bir özellik varsa true döndürür, yoksa false döndürür.
hasChildNodes() Belirtilen düğümün alt düğümü varsa true döndürür, yoksa false döndürür.
insertBefore() Belirtilen alt düğümün önüne yeni bir alt düğüm ekler.
isDefaultNamespace("URI) Belirtilen ad alanı URI'nin varsayılan olup olmadığını kontrol eder.
isEqualNode(" İki düğümün eşit olup olmadığını kontrol eder.
isSameNode() İki düğümün aynı olup olmadığını kontrol eder.
lookupNamespaceURI(" Belirtilen ön ekle ilişkili ad alanı URI'yi döndürür.
lookupPrefix(" Belirtilen ad alanı URI ile ilişkili ön eki döndürür.
normalize(" Yakınlaştırılmış metin düğümünü birleştirir ve boş metin düğümünü siler.
removeChild(" Belirtilen alt düğümü siler (ve döndürür).
replaceChild(" Alt düğümü yeni düğümle değiştirir.
setUserData("key,data,handler) Nesneyi düğümdeki anahtara bağlar.

Top

XML DOM NodeList nesnesi

NodeList nesnesi özellikleri

Özellik Tanım
length Düğüm listesindeki düğüm sayısını döndürür.

NodeList nesnesi yöntemleri

方法 Tanım
item() Gönderilen indeksteki düğümü döndürür.

Top

XML DOM NamedNodeMap nesnesi

NamedNodeMap nesnesinin özellikleri

Özellik Tanım
length Listedeki düğüm sayısını geri dönün.

NamedNodeMap nesnesinin yöntemleri

方法 Tanım
getNamedItem() Belirtilen adına sahip düğümü geri dönün.
getNamedItemNS() Belirtilen adı ve isim alanına sahip düğümü geri dönün.
item() Belirtilen indeksteki düğümü geri dönün.
removeNamedItem() Belirtilen adına sahip düğümü silin.
removeNamedItemNS() Belirtilen adı ve isim alanına sahip düğümü silin.
setNamedItem() Belirtilen düğümü (adına göre) ayarlayın.
setNamedItemNS() Belirtilen düğümü (adı ve isim alanına göre) ayarlayın.

Top

XML DOM Document nesnesi

Document nesnesinin özellikleri

Özellik Tanım
childNodes Belgenin alt düğümlerinin NodeList'ini geri dönün.
doctype Belge ile ilişkili olan belge türü beyanını geri dönün.
documentElement Belgenin kök düğümünü geri dönün.
documentURI Belgenin konumunu ayarlayın veya geri dönün.
domConfig normalizeDocument() çağrılırken kullanılan yapıyı geri dönün.
firstChild Belgenin ilk alt düğümünü geri dönün.
implementation Bu belgeyi işleyen DOMImplementation nesnesini geri dönün.
inputEncoding Belgenin çözümleme sırasında kullandığı kodlama yöntemini geri dönün.
lastChild Belgenin en son alt düğümünü geri dönün.
nodeName Düğümün adını geri dönün (düğüm türüne bağlıdır).
nodeType Düğümün düğüm türünü geri dönün.
nodeValue Düğümün değerini ayarlayın veya geri dönün (düğüm türüne bağlıdır).
xmlEncoding Belgenin XML kodlama yöntemini geri dönün.
xmlStandalone Belgenin bağımsız olup olmadığını ayarlayın veya geri dönün.
xmlVersion Belgenin XML sürümünü ayarlayın veya geri dönün.

Document nesnesinin yöntemleri

方法 Tanım
adoptNode() Başka bir belgedeki düğümü bu belgeye alın ve alınan düğümü geri dönün.
createAttribute() Belirtilen adı sahip bir özellik düğümü oluşturun ve yeni Attr nesnesini geri dönün.
createAttributeNS() Belirtilen adı ve isim alanını sahip bir özellik düğümü oluşturun ve yeni Attr nesnesini geri dönün.
createCDATASection() CDATA bölümü düğümü oluşturun.
createComment() Yorum düğümü oluşturun.
createDocumentFragment() Boş DocumentFragment nesnesi oluşturun ve geri dönün.
createElement() Element düğümünü oluşturur.
createElementNS() Belirtilen ad alanına sahip element düğümünü oluşturur.
createEntityReference() EntityReference nesnesi oluşturur ve bu nesneyi döndürür.
createProcessingInstruction() ProcessingInstruction nesnesi oluşturur ve bu nesneyi döndürür.
createTextNode() Metin düğümünü oluşturur.
getElementById() Belirtilen değeri olan id özelliğine sahip elementi döndürür.
getElementsByTagName() Belirtilen adı olan tüm elementlerin NodeList'ini döndürür.
getElementsByTagNameNS() Belirtilen ad ve ad alanına sahip tüm elementlerin NodeList'ini döndürür.
importNode() Düğümü başka bir belgeden bu belgeye aktarır.
Belgeyi normalize eder.
renameNode() Element veya özellik düğümünü yeniden adlandırır.

DocumentType nesnesinin özellikleri

Her belge, null veya DocumentType nesnesi olan bir DOCTYPE özelliğine sahiptir.

DocumentType nesnesi, XML belgesi için tanımlanan varlıkların arayüzünü sağlar.

Özellik Tanım
name DTD'nin adını döndürür.
publicId DTD'nin kamusal tanımlayıcısını döndürür.
systemId Dışarıdaki DTD'nin sistem tanımlayıcısını döndürür.

DocumentImplementation nesnesinin yöntemleri

DOMImplementation nesnesi, belge nesnesi modeline bağımsız herhangi bir özel örnek işlemi gerçekleştirir.

方法 Tanım
createDocument() Belirtilen belge türünü yeni DOM Document nesnesi olarak oluşturur.
createDocumentType() Boş DocumentType düğümünü oluşturur.
getFeature() Belirtilen özellik ve sürümü destekleyen API nesnesini döndürür (varsa).
hasFeature() DOM uygulaştırmasının belirli özellikleri ve sürümlerini gerçekten destekleyip desteklemediğini kontrol eder。

ProcessingInstruction nesnesinin özellikleri

ProcessingInstruction nesnesi, işaretleyiciyi temsil eder.

İşaretleyiciler, XML belge metninde işleyici belirli bilgilerini tutmak için kullanılan bir yöntemdir.

Özellik Tanım
data İşaretleyici içeriğini ayarlar veya döndürür。
target Bu işaretleyicinin hedefini döndürür。

Top

XML DOM Element nesnesi

Element nesnesinin özellikleri

Özellik Tanım
attributes 元素的属性的 NamedNodeMap 返回。
baseURI Bu elementin mutlak referans URI'sini döndürür.
childNodes Bu elementin alt nodlarının NodeList'ini döndürür.
firstChild Bu elementin ilk alt elementini döndürür.
lastChild Bu elementin son alt elementini döndürür.
localName Bu element adının yerel kısmını döndürür.
namespaceURI Bu elementin isim alanı URI'sini döndürür.
nextSibling Bu elementin hemen sonraki nodunu döndürür.
nodeName Bu nodun adını, türüne bağlı olarak döndürür.
nodeType 返回节点的类型。
ownerDocument Bu nodun kök elementini (belge nesnesi) döndürür.
parentNode Bu elementin ana nodunu döndürür.
prefix Bu elementin isim alanı önekiyi ayarlar veya döndürür.
previousSibling Bu elementin hemen önceki nodunu döndürür.
schemaTypeInfo Bu elementle ilgili tür bilgilerini döndürür.
tagName Bu elementin adını döndürür.
textContent Bu element ve altlarının metin içeriğini ayarlar veya döndürür.

Element nesnesi yöntemleri

方法 Tanım
appendChild() Yeni alt nodu bu noda alt nod listesinin sonuna ekler.
cloneNode() Nodu klonlar.
compareDocumentPosition() İki nodun belge konumunu karşılaştırır.
getAttribute() Özelliğin değerini döndürür.
getAttributeNS() Ad alanına sahip özelliğin değerini döndürür.
getAttributeNode() Özellik nodunu Attribute nesnesi olarak döndürür.
getAttributeNodeNS() Ad alanına sahip özellik nodunu Attribute nesnesi olarak döndürür.
getElementsByTagName() Belirtilen ad ve isim alanına sahip element nodu ve alt nodları ile NodeList döndürür.
getElementsByTagNameNS() Belirtilen ad ve isim alanına sahip element nodu (ad alanı) ve alt nodları ile NodeList döndürür.
getFeature(feature,version) Belirtilen özellik ve sürümle özel API'yi gerçekleştiren DOM nesnesini döndürür.
getUserData(key) Bu nod üzerindeki anahtarla ilişkili nesneyi döndürür. Öncelikle nesneyi bu noda ayarlamak gerekir, setUserData ile aynı anahtarı kullanarak çağrılır.
hasAttribute() Bu elementin belirtilen adına sahip özelliğe sahip olup olmadığını döndürür.
hasAttributeNS() Bu elementin belirtilen ad ve isim alanına sahip özelliğe sahip olup olmadığını döndürür.
hasAttributes() Bu elementin özelliklere sahip olup olmadığını döndürür.
hasChildNodes() Dönüşüm, bu elementin alt nodları olup olmadığını belirtir.
insertBefore() Mevcut alt düğümün önce yeni alt düğümü ekler.
isDefaultNamespace("URI) Belirtilen namespaceURI'nin öntanımlı olup olmadığını döndürür.
isEqualNode(" İki düğümün eşit olup olmadığını kontrol eder.
lookupNamespaceURI(" Belirtilen önekle eşleşen ad alanı URI'si döndürür.
lookupPrefix(" Belirtilen ad alanı URI'si ile eşleşen öneki döndürür.
normalize("

normalize() yöntemi boş metin düğümlerini kaldırır ve komşu metin düğümlerini birleştirir.

Element altındaki tüm metin düğümlerini (özellikler de dahil) standartlaştırır, yalnızca yapılar (örneğin, element, yorum, işlem talimatları, CDATA bölümleri ve entity referansları) metin düğümleri aralarında ayırır.

Yani, hem komşu metin düğümleri hem de boş metin düğümleri yok.

removeAttribute(" Belirtilen özelliği siler.
removeAttributeNS(" Belirtilen özelliği (ad alanı ile birlikte) siler.
removeAttributeNode(" Belirtilen özellik düğümünü siler.
removeChild(" Alt düğümü siler.
replaceChild(" Alt düğümü değiştirir.
setUserData("key,data,handler) Nesneyi element üzerindeki anahtara bağlar.
setAttribute(" Yeni özellik ekler.
setAttributeNS(" Yeni özellik (ad alanı ile birlikte) ekler.
setAttributeNode(" Yeni özellik düğümünü ekler.
setAttributeNodeNS("attrnode) Yeni özellik düğümünü (ad alanı ile birlikte) ekler.
setIdAttribute("name,isId) Attribute nesnesinin isId özelliği true ise, bu yöntem belirtilen özelliği kullanıcı tanımlı ID özelliği olarak tanımlar.
setIdAttributeNS("uri,name,isId) Attribute nesnesinin isId özelliği true ise, bu yöntem belirtilen özelliği (ad alanı ile birlikte) kullanıcı tanımlı ID özelliği olarak tanımlar.
setIdAttributeNode("idAttr,isId) Attribute nesnesinin isId özelliği true ise, bu yöntem belirtilen özelliği kullanıcı tanımlı ID özelliği olarak tanımlar.

Top

Attr nesnesinin özellikleri

Özellik Tanım
baseURI 属性的绝对基准 URI 返回。
isId 属性是 id 类型如果是,则返回 true,否则返回 false。
localName 属性名称的本地部分返回。
name 属性的名称返回。
namespaceURI 属性的命名空间 URI 返回。
nodeName 返回节点的名称,根据其类型。
nodeType 返回节点的类型。
nodeValue 设置或返回节点的值,根据其类型。
ownerDocument 返回属性的根元素(文档对象)。
ownerElement 返回属性所附属的元素节点。
prefix 设置或返回属性的命名空间前缀。
schemaTypeInfo 返回与该属性相关联的类型信息。
specified

如果在文档中设置了该属性值,则返回 true;

如果属性值是 DTD/Schema 中的默认值,则返回 false。

textContent 设置或返回属性的文本内容。
value 设置或返回属性的值。

Top

XML DOM Text nesnesi

Text 对象的属性

Özellik Tanım
data 设置或返回元素或属性的文本。
isElementContentWhitespace 判断文本节点是否包含空白字符内容。
length 返回元素或属性的文本长度。
wholeText 返回与该节点相邻的文本节点的所有文本,按文档顺序连接。

Text 对象的方法

方法 Tanım
appendData() 将数据追加到节点。
deleteData() 从节点中删除数据。
insertData() 将数据插入节点中。
replaceData() 替换节点中的数据。
replaceWholeText(text) 用指定的文本替换该节点和所有相邻文本节点的文本。
splitText() 把一个 Text 节点拆分成两个。
substringData() 从节点中提取数据。

Top

XML DOM CDATASection nesnesi

CDATASection 对象的属性

Özellik Tanım
data 设置或返回该节点的文本。
length 返回 CDATA 部分的长度。

CDATASection 对象的方法

方法 Tanım
appendData() 将数据追加到节点。
deleteData() 从节点中删除数据。
insertData() 将数据插入节点中。
replaceData() 替换节点中的数据。
splitText() 将 CDATA 节点拆分为两个节点。
substringData() 从节点中提取数据。

Top

XML DOM Comment nesnesi

Comment 对象的属性

Özellik Tanım
data 设置或返回该节点的文本。
length 返回该节点的文本长度。

Comment 对象的方法

方法 Tanım
appendData() 将数据追加到节点。
deleteData() 从节点中删除数据。
insertData() 将数据插入节点中。
replaceData() 替换节点中的数据。
substringData() 从节点中提取数据。

Top

XML DOM XMLHttpRequest nesnesi

XMLHttpRequest 对象的方法

方法 Tanım
abort() 取消当前请求。
getAllResponseHeaders() 返回标头信息。
getResponseHeader() 返回指定的 HTTP 响应头部的值。
open(method,url,async,uname,pswd)

请求的类型、URL、是否异步处理请求以及其他可选属性的指定。

  • method: İstek türü: GET veya POST
  • url: Dosyanın sunucudaki konumu
  • async: true (asenkron) veya false (senkron)
send(string)

İsteki sunucuya gönderin.

string: Sadece POST istekleri için kullanılır.

setRequestHeader() Etiket/değer çiftini gönderilecek başlıklara ekleyin.

XMLHttpRequest nesnesinin özellikleri

Özellik Tanım
onreadystatechange Her readyState özelliği değişikliği sırasında otomatik olarak çağrılan fonksiyon (veya fonksiyon adı).
readyState

XMLHttpRequest'in durumunu kaydeder. 0'dan 4'e değişen değişkenler:

  • 0: İstek başlatılmamıştır.
  • 1: Sunucu bağlantısı kurulmuştur.
  • 2: İstek alınmıştır.
  • 3: İstek işleniyor.
  • 4: İstek tamamlanmıştır, yanıt hazır.
responseText String olarak yanıt veri döndürür.
responseXML XML verisi olarak yanıt veri döndürür.
status Durum numarasını döndürür (örneğin "404" "Not Found" olarak, veya "200" "OK" olarak).
statusText Durum metnini döndürür (örneğin "Not Found" veya "OK").

Top

XSD öğeleri

XSLT elementi Açıklama
all Alt öğelerin rastgele sırayla出现, her alt öğenin sıfır veya bir kez出现.
annotation Annotation öğesi, schema'nın açıklamalarını belirleyen bir üst düzey öğedir.
any Yaratıcıların schema tarafından tanımlanmamış öğeler aracılığıyla XML belgesini genişletmesini sağlar.
anyAttribute Yaratıcıların schema tarafından tanımlanmamış özellikler aracılığıyla XML belgesini genişletmesini sağlar.
appInfo Annotation öğesinde uygulama tarafından kullanılacak bilgileri belirtin.
Bir şablonu mevcut element veya mevcut elementin çocuklarına uygulayın. Bir özellik tanımlayın.
attributeGroup Kompleks tür tanımlarında kullanılan özellik gruplarını tanımlayın.
choice Yalnızca <choice> bildiriminde bir öğenin iç öğelerde görünmesini izinleyin.
complexContent Kompleks türler (karışık içerik içeren veya sadece öğeler içeren) için genişlemeler veya sınırlamalar tanımlayın.
complexType Kompleks türleri tanımlayın.
documentation Schema'daki metin açıklamalarını tanımlayın.
element Bir öğeyi tanımlayın.
extension Zaten var olan simpleType veya complexType öğelerini genişletin.
field Tanımlayıcı kısıtlamalar için kullanılan XPath ifadesini belirler.
group complexType tanımlarında kullanılan element gruplarını tanımlar.
import Farklı hedef isim alanlarına sahip birden fazla schema'ı bir belgeye ekler.
include Aynı hedef isim alanına sahip birden fazla schema'ı bir belgeye ekler.
key Öznitelik veya element değerinin (veya bir grup değer) belirtilen aralıkta bir anahtar olmalıdır.
keyref Öznitelik veya element değerinin (veya bir grup değer) belirtilen anahtar veya benzersiz element değerine karşılık gelmesi gerektiği belirtilir.
list Basit türleri, belirtilen veri türlerinin değerlerinin bir listesi olarak tanımlar.
notation XML belgesinde XML olmayan veri formatını tanımlar.
redefine Dışarıdan alınan basit ve karmaşık türler, gruplar ve öznitelik gruplarını yeniden tanımlar.
restriction simpleType, simpleContent veya complexContent için kısıtlamalar tanımlar.
schema Schema'nın kök elementini tanımlar.
selector Bir XPath ifadesi belirterek, bu ifade, tanımlayıcı kısıtlamalar için bir grup element seçer.
sequence Alt elementlerin sırayla出现 zorunludur. Her alt element 0'dan bir veya daha fazla kez出现 olabilir.
simpleContent complexType elementlerine genişleme veya sınırlama içermeyen ve hiçbir element içermeyen.
simpleType Bir basit tür tanımlar, sınırlamalar ve öznitelik veya sadece metin içeren elementlerin değerleri hakkında bilgi sağlar.
union Birkaç simpleType tanımı kapsayan bir koleksiyon tanımlar.
unique Öznitelik veya element değerinin (veya öznitelik veya element değerlerinin bir kombinasyonunun) belirtilen aralıkta benzersiz olmalıdır.

Veri türlerinin XSD sınırlamaları

XSD Sınırlamaları / Facets'a bakın

Sınırlama Tanım
enumeration Kabul edilebilir değerlerin bir listesi
fractionDigits İzin verilen en fazla ondalık basamak sayısı. Bu değer 0'dan büyük veya eşit olmalıdır.
length İzin verilen karakter veya liste öğesi sayısının kesin sayısı. Bu değer 0'dan büyük veya eşit olmalıdır.
maxExclusive Bu değerin üstünde olan değerlerin kullanılması yasaktır. İzin verilen değerler, bu değere eşit veya daha küçük olmalıdır.
maxInclusive Bu değerin üstünde olan değerlerin kullanılması yasaktır. İzin verilen değerler, bu değere eşit veya daha küçük olmalıdır.
maxLength İzin verilen karakter veya liste öğesi sayısının en fazla sayısı. Bu değer 0'dan büyük veya eşit olmalıdır.
minExclusive Bu değerin altında olan değerlerin kullanılması yasaktır. İzin verilen değerler, bu değere eşit veya daha büyük olmalıdır.
minInclusive Bu değerin altında olan değerlerin kullanılması yasaktır. İzin verilen değerler, bu değere eşit veya daha büyük olmalıdır.
minLength İzin verilen karakterler veya liste öğelerinin en küçük sayısını tanımlayın. 0 veya daha büyük olmalıdır.
İzin verilen karakterler veya liste öğelerinin en küçük sayısını tanımlayın. 0 veya daha büyük olmalıdır. pattern
Kabul edilebilir karakterlerin doğru dizisini tanımlayın. totalDigits
İzin verilen Arap rakamlarının doğru sayısını tanımlayın. 0'dan büyük olmalıdır. whiteSpace

Top

Beyaz boşluk karakterlerinin işlenme yöntemini tanımlayın (satır başı, geri tuşu, boşluk ve tab).

XSLT elementi Tanım
element apply-imports
İçe aktarılan stil sheetsinden gelen şablon kurallarını uygulayın. apply-templates
Bir şablonu mevcut element veya mevcut elementin çocuklarına uygulayın. Bir elemente özellik ekleyin.
attribute-set Adlandırılmış bir özellik kümesi oluşturun.
call-template Belirtilen bir şablonu çağırın.
choose <when> ve <otherwise> ile birlikte kullanılarak, çoklu koşul testlerini ifade etmek için kullanılır.
comment Sonuç ağacında bir yorum düğümü oluşturun.
copy Mevcut düğümün bir yedek kopyasını oluşturun (çocuk düğümleri ve özellikleri olmadan).
copy-of Mevcut düğümün bir yedek kopyasını oluşturun (çocuk düğümleri ve özellikleri ile birlikte).
decimal-format format-number() fonksiyonu ile sayıları dizgeye dönüştürdüğünüzde kullanılacak karakterleri ve sembolleri tanımlayın.
element Çıktı belgesinde bir element düğümü oluşturun.
fallback İşleyici belirli bir XSLT elementini desteklemiyorsa, çalıştırılacak bir yedek kod tanımlayın.
for-each Belirtilen düğüm kümesindeki her düğümü tarayın.
if Belirli bir koşulun yerine getirildiği takdirde, bir şablonu içeren bir şablonu içerir.
import Bir stil sheetsindeki içeriği diğer bir stil sheetsine akıtmak için kullanılır.
include Bir stil sheetsindeki içeriği diğer bir stil sheetsine dahil edin.
key Adlandırılmış bir anahtar tanımlayın.
message Çıktıya bir mesaj yazın (hata bildirimleri için kullanılır).
namespace-alias Stil sheetsindeki adlandırılmış alan adlarını çıktıdaki farklı alan adları ile değiştirin.
number Mevcut düğümün tamsayı konumunu belirleyin ve sayıları biçimlendirin.
otherwise <choose> elementinin varsayılan eylemini belirtin.
output Çıktı belgesinin formatını tanımlayın.
param Yerel veya genel bir parametre tanımlayın.
preserve-space Boşlukları korumak için element tanımlanmalıdır.
processing-instruction İşlem talimatı düğümünü oluşturun.
sort Sonuçları sıralayın.
strip-space Beyaz boşluk karakterlerini silmek için element tanımlanmalıdır.
stylesheet tarz şablonunun kök elementini tanımlar.
template belirtilen düğüm eşleştiğinde uygulanan kurallar.
text tarz şablonu ile metin düğümü oluşturur.
transform tarz şablonunun kök elementini tanımlar.
value-of seçili düğümün değerini çıkarır.
variable lokalli veya genel değişkenleri tanımlar.
when <choose> elementinin eylemini belirler.
with-param belirli bir şablonun parametresinin değerini belirler.

Top

XSLT, XPath ve XQuery Fonksiyonları

erişim fonksiyonları

Ad Açıklama
fn:node-name(node) parametre düğümünün düğüm adını döndürür.
fn:nilled(node) parametre düğümünü reddetip reddetmediğini belirleyen doğru değer
fn:data(item.item,...) proje sırasını kabul eder ve atomik değer sırası döndürür.
  • fn:base-uri()
  • fn:base-uri(node)
mevcut düğüm veya belirtilen düğümün base-uri özelliğinin değerini döndürür.
fn:document-uri(node) belirtilen düğümün document-uri özelliğinin değerini döndürür.

hata ve takip fonksiyonları

Ad Açıklama
  • fn:error()
  • fn:error(error)
  • fn:error(error,description)
  • fn:error(error,description,error-object)

örnek: error(fn:QName('http://example.com/test', 'err:toohigh'), 'Hata: Fiyat çok yüksek')

Sonuç: Dış işlem ortamına http://example.com/test#toohigh ve "Hata: Fiyat çok yüksek" dizisini döndürür.

fn:trace(value,label) sorguyu debug etmek için kullanılır.

sayısal fonksiyonlar

Ad Açıklama
fn:number(arg)

parametrenin sayısal değerini döndürür. Parametre, doğru değer, string veya node seti olabilir.

örnek: number('100')

Sonuç: 100

fn:abs(num)

parametrenin mutlak değerini döndürür.

örnek: abs(3.14)

Sonuç: 3.14

örnek: abs(-3.14)

Sonuç: 3.14

fn:ceiling(num)

num parametresinin büyük整数值

örnek: ceiling(3.14)

Sonuç: 4

fn:floor(num)

num parametresinin en büyük, num'dan küçük veya eşit olan tam sayısını döndürür.

Örnek: floor(3.14)

Sonuç: 3

fn:round(num)

num parametresini en yakın tam sayıya yuvarlar.

Örnek: round(3.14)

Sonuç: 3

fn:round-half-to-even()

Örnek: round-half-to-even(0.5)

Sonuç: 0

Örnek: round-half-to-even(1.5)

Sonuç: 2

Örnek: round-half-to-even(2.5)

Sonuç: 2

Dizge fonksiyonları hakkında

Ad Açıklama
fn:string(arg)

Parametrenin dizge değerini döndürür. Parametre sayı, mantıksal değer veya düğüm kümesi olabilir.

Örnek: string(314)

Sonuç: "314"

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

Kod noktası dizisine göre dizge döndürür.

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

Sonuç: 'Thérèse'

fn:string-to-codepoints(string)

Dizgeye göre kod noktası dizisi döndürür.

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

Sonuç: 84, 104, 233, 114, 232, 115, 101

fn:codepoint-equal(comp1,comp2) Unicode kod noktası karşılaştırmasına göre, comp1'nin değeri comp2'nin değeriyle eşitse true döndürür. (http://www.w3.org/2005/02/xpath-functions/collation/codepoint), aksi takdirde false döndürür.
  • fn:compare(comp1,comp2)
  • fn:compare(comp1,comp2,karşılaştırma)

comp1 comp2'dan küçükse -1 döndürür. comp1 comp2'ye eşitse 0 döndürür. comp1 comp2'dan büyükse 1 döndürür. (Kullanılan karşılaştırma kurallarına göre).

Örnek: compare('ghi', 'ghi')

Sonuç: 0

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

Dizge birleştirmesi döndürür.

Örnek: concat('XPath ','is ','FUN!')

Sonuç: 'XPath eğlenceli!

fn:birleştir(string,string,...,ayraç)

sep parametresini ayırıcı olarak kullanarak string parametresini birleştirilmiş diziyi döner.

Örnek: string-join(('We', 'are', 'having', 'fun!'), ' ')

Sonuç: ' We are having fun! '

Örnek: string-join(('We', 'are', 'having', 'fun!'))

Sonuç: 'Wearehavingfun!'

Örnek: string-join((), 'sep')

Sonuç: ''

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

start konumundan başlayan belirtilen uzunlukta bir alt diziyi döner. İlk karakterin altı 1'dir. len parametresi atlanırsa, position start'tan dize sonuna kadar olan alt diziyi döner.

Örnek: substring('Beatles',1,4)

Sonuç: 'Beat'

Örnek: substring('Beatles',2)

Sonuç: 'eatles'

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

Belirtilen dizinin uzunluğunu döner. string parametresi yoksa, mevcut düğümün string değerinin uzunluğunu döner.

Örnek: string-length('Beatles')

Sonuç: 7

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

Belirtilen dizinin başlangıç ve bitişindeki beyaz boşlukları silir, içdeki tüm beyaz boşluk dizilerini birleştirir ve sonuç döner. string parametresi yoksa, mevcut düğümü işler.

Örnek: normalize-space(' The   XML ')

Sonuç: 'The XML'

fn:normalize-unicode() Unicode规范执行.
fn:upper-case(string)

string parametresini büyük harflere dönüştürür.

Örnek: upper-case('The XML')

Sonuç: 'THE XML'

fn:lower-case(string)

string parametresini küçük harflere dönüştürür.

Örnek: lower-case('The XML')

Sonuç: 'the xml'

fn:translate(string1,string2,string3)

string1 içinde string2'yi string3 ile değiştir.

Örnek: translate('12:30','30','45')

Sonuç: '12:45'

Örnek: translate('12:30','03','54')

Sonuç: '12:45'

Örnek: translate('12:30','0123','abcd')

Sonuç: 'bc:da'

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

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

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

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

Sonuç: "http://example.com/test#car"

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

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

fn:contains(string1,string2)

string1 string2 içeriyorsa true döndürür, aksi takdirde false döndürür.

Örnek: contains('XML','XM')

Sonuç: true

fn:starts-with(string1,string2)

string1 string2 ile başlıyorsa true döndürür, aksi takdirde false döndürür.

Örnek: starts-with('XML','X')

Sonuç: true

fn:ends-with(string1,string2)

string1 string2 ile bitiyorsa true döndürür, aksi takdirde false döndürür.

Örnek: ends-with('XML','X')

Sonuç: false

fn:substring-before(string1,string2)

string1 içinde string2'nin önceki alt dizgesini döndürür.

Örnek: substring-before('12/10','/')

Sonuç: '12'

fn:substring-after(string1,string2)

string1 içinde string2'nin ardından bulunan alt dizgeyi döndürür.

Örnek: substring-after('12/10','/')

Sonuç: '10'

fn:matches(string,pattern)

string parametresi belirtilen modelle eşleşiyorsa true döndürür, aksi takdirde false döndürür.

Örnek: matches("Merano", "ran")

Sonuç: true

fn:replace(string,pattern,replace)

Belirtilen modeli replace parametresi ile değiştir ve sonuç döndür.

Örnek: replace("Bella Italia", "l", "*")

Sonuç: 'Be**a Ita*ia'

Örnek: replace("Bella Italia", "l", "")

Sonuç: 'Bea Itaia'

fn:tokenize(string,pattern)

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

Sonuç: ("XPath", "is", "fun")

anyURI için fonksiyonlar

Ad Açıklama
fn:resolve-uri(relative,base)  

Boolean değer hakkında

Ad Açıklama
fn:boolean(arg) Sayı, string veya nod setinin boolean değerini döndürür.
fn:not(arg)

Öncelikle boolean() fonksiyonu ile parametreyi bir boolean değere dönüştürür.

Boolean değeri false ise true döndürür, aksi takdirde true döndürür.

Örnek: not(true())

Sonuç: false

fn:true()

Boolean değer döndürür true.

Örnek: true()

Sonuç: true

fn:false()

Boolean değer döndürür false.

Örnek: false()

Sonuç: false

Süre, tarih ve zaman fonksiyonları hakkında

Tarih, zaman ve süre komponentlerinin çıkarım fonksiyonu

Ad Açıklama
fn:dateTime(date,time) Parametreyi tarih ve zaman olarak dönüştürür.
fn:years-from-duration(datetimedur) Dönüt parametresinin yıl kısmının tam sayısını standart sözcük ifadesi ile ifade eder.
fn:months-from-duration(datetimedur) Dönüt parametresinin ay kısmının tam sayısını standart sözcük ifadesi ile ifade eder.
fn:days-from-duration(datetimedur) Dönüt parametresinin gün kısmının tam sayısını standart sözcük ifadesi ile ifade eder.
fn:hours-from-duration(datetimedur) Parametrenin saat kısmını gösteren tamsayıyı standart sözdizimi ile döndürür.
fn:minutes-from-duration(datetimedur) Parametrenin dakika kısmını gösteren tamsayıyı standart sözdizimi ile döndürür.
fn:seconds-from-duration(datetimedur) Parametrenin dakika kısmını gösteren ondalık sayıyı standart sözdizimi ile döndürür.
fn:year-from-dateTime(datetime)

Parametrenin yerel değerinin yıl kısmını gösteren tamsayıyı döndürür.

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

Sonuç: 2005

fn:month-from-dateTime(datetime)

Parametrenin yerel değerinin ay kısmını gösteren tamsayıyı döndürür.

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

Sonuç: 01

fn:day-from-dateTime(datetime)

Parametrenin yerel değerinin gün kısmını gösteren tamsayıyı döndürür.

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

Sonuç: 10

fn:hours-from-dateTime(datetime)

Parametrenin yerel değerinin saat kısmını gösteren tamsayıyı döndürür.

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

Sonuç: 12

fn:minutes-from-dateTime(datetime)

Parametrenin yerel değerinin dakika kısmını gösteren tamsayıyı döndürür.

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

Sonuç: 30

fn:seconds-from-dateTime(datetime)

Parametrenin yerel değerinin saniye kısmını gösteren ondalık sayıyı döndürür.

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

Sonuç: 0

fn:timezone-from-dateTime(datetime) Varsa parametrenin zaman dilimi kısmını döndürür.
fn:year-from-date(date)

Parametrenin yerel değerinde yılı gösteren tamsayıyı döndürür.

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

Sonuç: 2005

fn:month-from-date(date)

Parametrenin yerel değerinde ayı temsil eden tamsayıyı döndürür.

Örnek: month-from-date(xs:date("2005-04-23"))

Sonuç: 4

fn:day-from-date(date)

Parametrenin yerel değerinde günü temsil eden tamsayıyı döndürür.

Örnek: day-from-date(xs:date("2005-04-23"))

Sonuç: 23

fn:timezone-from-date(date) Varsa parametrenin zaman dilimi kısmını döndürür.
fn:hours-from-time(time)

Parametrenin yerel değerinde saat kısmını temsil eden tamsayıyı döndürür.

Örnek: hours-from-time(xs:time("10:22:00"))

Sonuç: 10

fn:minutes-from-time(time)

Parametrenin yerel değerinde dakika kısmını temsil eden tamsayıyı döndürür.

Örnek: minutes-from-time(xs:time("10:22:00"))

Sonuç: 22

fn:seconds-from-time(time)

Parametrenin yerel değerinde saniye kısmını temsil eden tamsayıyı döndürür.

Örnek: seconds-from-time(xs:time("10:22:00"))

Sonuç: 0

fn:timezone-from-time(time) Varsa parametrenin zaman dilimi kısmını döndürür.
fn:adjust-dateTime-to-timezone(datetime,timezone)

timezone parametresi boşsa, zaman dilimi olmayan dateTime döndürülür。

Aksi takdirde zaman dilimi ile birlikte dateTime döndürülür。

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

timezone parametresi boşsa, zaman dilimi olmayan date döndürülür。

Aksi takdirde zaman dilimi ile birlikte date döndürülür。

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

timezone parametresi boşsa, zaman dilimi olmayan time döndürülür。

Aksi takdirde zaman dilimi ile birlikte time döndürülür。

İle QNames ile ilgili fonksiyonlar

Ad Açıklama
fn:QName()  
fn:local-name-from-QName()  
fn:namespace-uri-from-QName()  
fn:namespace-uri-for-prefix()  
fn:in-scope-prefixes()  
fn:resolve-QName()  

düğüm fonksiyonları hakkında

Ad Açıklama
  • fn:name()
  • fn:name(nodeset)
geçerli düğümün adını veya belirtilen düğüm kümesinin ilk düğümünün adını döner.
  • fn:local-name()
  • fn:local-name(nodeset)
geçerli düğümün adını veya belirtilen düğüm kümesinin ilk düğümünün adını - ad alan öncesi ile döner.
  • fn:namespace-uri()
  • fn:namespace-uri(nodeset)
geçerli düğüm veya belirtilen düğüm kümesinin ilk düğümünün ad alan URI'sini döner.
fn:lang(lang)

geçerli düğümün dilı ile belirtilen dilı eşleşiyorsa true döner.

örnek: Lang("en") için true <p xml:lang="en">...</p>

örnek: Lang("de") için false <p xml:lang="en">...</p>

  • fn:root()
  • fn:root(node)
geçerli düğüm veya belirtilen düğümün düğüm ağacının kök düğümünü döner. Genellikle belge düğümüdür.

dizi fonksiyonları

genel fonksiyon

Ad Açıklama
fn:index-of((item,item,...),searchitem)

proje dizgisinde searchitem parametresine eşit olan konumları döner.

örnek: index-of ((15, 40, 25, 40, 10), 40)

Sonuç: (2, 4)

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

Sonuç (1, 4)

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

Sonuç: ()

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

item parametresi ile oluşturulan yeni diziyi döner - position parametresi belirtilen öğeyi siler.

örnek: remove(("ab", "cd", "ef"), 0)

Sonuç: ("ab", "cd", "ef")

örnek: remove(("ab", "cd", "ef"), 1)

Sonuç: ("cd", "ef")

örnek: remove(("ab", "cd", "ef"), 4)

Sonuç: ("ab", "cd", "ef")

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

parametre değeri boş dizgi ise true döner, aksi takdirde false döner.

örnek: empty(remove(("ab", "cd"), 1))

Sonuç: false

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

Parametre değeri boş dizisi değilse true döndürür, aksi takdirde false döndürür.

Örnek: exists(remove(("ab"), 1))

Sonuç: false

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

Tekil farklı değerleri döndürür.

Örnek: distinct-values((1, 2, 3, 1, 2))

Sonuç: (1, 2, 3)

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

item parametresi ile oluşturulan yeni diziyi döndürür - aynı zamanda pos parametresi belirtilen konuma inserts parametresinin değerini ekler.

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

Sonuç: ("gh", "ab", "cd")

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

Sonuç: ("gh", "ab", "cd")

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

Sonuç: ("ab", "gh", "cd")

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

Sonuç: ("ab", "cd", "gh")

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

Belirtilen projelerin ters sırasını döndürür.

Örnek: reverse(("ab", "cd", "ef"))

Sonuç: ("ef", "cd", "ab")

Örnek: reverse(("ab"))

Sonuç: ("ab")

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

start parametresi belirtilen konumdan döndürülen projeler dizisini, dizinin uzunluğu len parametresi tarafından belirlenir.

İlk projenin konumu 1'dir.

Örnek: subsequence(($item1, $item2, $item3,...), 3)

Sonuç: ($item3, ...)

Örnek: subsequence(($item1, $item2, $item3, ...), 2, 2)

Sonuç: ($item2, $item3)

fn:unordered((item,item,...)) Geri döndürülen projelerin sırasını gerçekleştirmeye bağlı olarak belirler.

Test sırası kapasitesini belirleyen fonksiyon

Ad Açıklama
fn:zero-or-one(item,item,...) Parametre sıfır veya bir projeyi içeriyorsa parametreyi döndürür, aksi takdirde hata oluşturur.
fn:one-or-more(item,item,...) Parametre bir veya daha fazla projeyi içeriyorsa parametreyi döndürür, aksi takdirde hata oluşturur.
fn:exactly-one(item,item,...) Parametre bir projeyi içeriyorsa parametreyi döndürür, aksi takdirde hata oluşturur.

Eşit, Birleşim, Çarpım ve Fark

Ad Açıklama
fn:deep-equal(param1,param2,collation) param1 ve param2 benzerse (derin-benzerlik), true döndürür, aksi takdirde false döndürür.

Toplam Fonksiyonları

Ad Açıklama
fn:count((item,item,...)) Düğüm sayısını döndürür.
fn:avg((arg,arg,...))

Parametre değerlerinin ortalamağını döndürür.

Örnek: avg((1,2,3))

Sonuç: 2

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

Diğer parametrelerden büyük olan parametreyi döndürür.

Örnek: max((1,2,3))

Sonuç: 3

Örnek: max(('a', 'k'))

Sonuç: 'k'

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

Diğer parametrelerden küçük olan parametreyi döndürür.

Örnek: min((1,2,3))

Sonuç: 1

Örnek: min(('a', 'k'))

Sonuç: 'a'

fn:sum(arg,arg,...) Belirtilen düğüm kümesindeki her düğümün sayısını döndürür.

Seri Oluşturma Fonksiyonları

Ad Açıklama
fn:id((string,string,...),node) ID değeri string parametresinde belirtilen bir veya birkaç değere eşit olan element düğüm sırasını döndürür.
fn:idref((string,string,...),node) IDREF değeri string parametresinde belirtilen bir veya birkaç değere eşit olan element veya özellik düğüm sırasını döndürür.
fn:doc(URI)  
fn:doc-available(URI) doc() fonksiyonu belge düğümünü döndürdüğünde true döndürür, aksi takdirde false döndürür.
  • fn:collection()
  • fn:collection(string)
 

Bağlam Fonksiyonları

Ad Açıklama
fn:position()

İşlenen mevcut düğümün index konumunu döndürür.

//book[position()<=3]

Sonuç: İlk üç book elemanını seç

fn:last()

İşlenen düğüm listesindeki öğe sayısını döndürür.

Örnek: //book[last()]

Sonuç: En son book elementini seçer

fn:current-dateTime() Zaman dilimi ile birlikte mevcut dateTime'yi döndürür。
fn:current-date() Zaman dilimi ile birlikte mevcut tarihi döndürür。
fn:current-time() Zaman dilimi ile birlikte mevcut zamanı döndürür。
fn:implicit-timezone() Gizli zaman dilimini döndürür。
fn:default-collation() Öntanımlı karşılaştırma değerini döndürür。
fn:static-base-uri() base-uri'nin değerini döndürür。

XSLT Fonksiyonları

Ayrıca, aşağıdaki XSLT fonksiyonları içeren içsel fonksiyonlar vardır:

Ad Tanım
current() Mevcut düğümü tek üyeli bir düğüm kümesine dönüştürür。
document() Dışarıdaki XML belgesindeki düğümlere erişmek için kullanılır。
element-available() XSLT işleyicisinin belirtilen elementi destekleyip desteklemediğini sorgular。
format-number() Sayıyı dizeye dönüştürür。
function-available() XSLT işleyicisinin belirtilen fonksiyonu destekleyip desteklemediğini sorgular。
generate-id() Belirtilen düğümü tanımlayan benzersiz bir dize değeri döndürür。
key() <xsl:key> ifadesi ile işaretlenmiş önceki elementleri alır。
node-set Ağacı düğüm kümesine dönüştürür. Oluşturulan düğüm kümesi her zaman tek düğüm içerir ve ağacın kök düğümüdür。
system-property() Sistem özelliğinin değerini döndürür。
unparsed-entity-uri() Henüz çözülmemiş birimi URI'sini döndürür。

Top

Diğer XML DOM nesneleri

Top