XSLT <xsl:output> elementi

Tanım ve Kullanım

<xsl:output> elementi çıktı belgesinin formatını tanımlar.

Açıklama:<xsl:output> üst düzey bir elementtir (top-level element) ve <xsl:stylesheet> veya <xsl:transform> elementlerinin alt nodusu olmalıdır.

Gramer

<xsl:output
method="xml|html|text|name"
version="string"
encoding="string"
omit-xml-declaration="yes|no"
standalone="yes|no"
doctype-public="string"
doctype-system="string"
cdata-section-elements="namelist"
indent="yes|no"
media-type="string"/>

Özellik

Özellik Değer Açıklama
method
  • xml
  • html
  • text
  • name
Opsiyonel. Çıktı formatını tanımlar. Varsayılan XML'dir. Netscape 6 yalnızca "html" ve "xml" destekler.
version string Opsiyonel. Çıktı formatının W3C sürüm numarasını ayarlar. (Sadece method="html" veya method="xml" kullanıldığında geçerlidir).
encoding string Opsiyonel. Çıktıdaki kodlama özelliğinin değerini ayarlar.
omit-xml-declaration
  • yes
  • no

Opsiyonel.

"yes" belge beyanının çıktıda atlanmasını belirtir (<?xml...?>).

"no" belge beyanının çıktıda içerilmesi gerektiğini belirtir. Varsayılan "no"'dur.

standalone
    • yes
    • no
Opsiyonel. XSLT işleyici'nin bağımsız belge beyanı çıkarması gerekip gerekmediğini belirler; bu değer "yes" veya "no" olmalıdır. Varsayılan "no"'dur. Netscape 6 bu özelliği desteklememektedir.
doctype-public string Opsiyonel. DTD'de kullanılacak genel tanımlayıcıyı belirtir. Yani çıktıdaki DOCTYPE bildiriminin PUBLIC özelliğinin değeri.
doctype-system string Opsiyonel. DTD'de kullanılacak sistem tanımlayıcısını belirtir. Yani çıktıdaki DOCTYPE bildiriminin SYSTEM özelliğinin değeri.
cdata-section-elements namelist Opsiyonel. Boşluk ayraçlı bir element listesi, bu elementlerin metin içeriği CDATA bölümü olarak çıktılmalıdır.
indent
  • yes
  • no
Opsiyonel. Çıktı ağacını oluştururken boşluk eklenip eklenmeyeceğini belirler; bu değer yes veya no olmalıdır. Netscape 6 bu özelliği desteklememektedir.
media-type string Opsiyonel. Çıktının MIME türünü (verilerin medya türünü) tanımlar. Varsayılan "text/xml"tir. Netscape 6 bu özelliği desteklememektedir.

method özelliği

Sonuç ağacını çıkaracak genel yöntemi tanımlayan bir işaret. Önceden bir önek yoksa, bu belgede belirtilen yöntemi tanımlar, "xml", "html", "text" veya NCName olmayan bir tanımlayıcı olmalıdır). Önceden bir önek varsa, açılır ve yöntemi tanımlar.

method özelliğinin varsayılan değeri aşağıdaki gibi seçilir. Eğer aşağıdaki herhangi bir koşul doğruysa, varsayılan çıktı yöntemi "html" olur:

Sonuç ağacının kök düğümü, element alt düğümü içerir.

Sonuç ağacının kök düğümü, element alt düğümü içerir. Genişleme adı yerel kısmı "html" (herhangi bir büyük/küçük harf kombinasyonu) ve boş adlandırma alanı URI'si içerir.

Sonuç ağacında kök düğümünün ilk element alt düğümünden önceki herhangi bir metin düğümü sadece boş karakterler içerir.

Aksi takdirde, varsayılan çıktı yöntemi "xml" olarak ayarlanmıştır. Eğer <xsl:output> elementi yoksa veya <xsl:output> elementi method özelliği belirtilmemişse, varsayılan çıktı yöntemini kullanmalıdır.

Örnek

Örnek 1

Bu örnekte, çıktı XML belgesidir, sürümü 1.0'dır. Karakter kodlama yöntemi "ISO-8859-1" olarak ayarlanmıştır, okunabilirliği artırmak için çıktı yuvarlanmıştır:

<?xml version="1.0" encoding="ISO-8859-1"?>
<xsl:stylesheet version="1.0"
xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
<xsl:output method="xml" version="1.0" encoding="iso-8859-1" indent="yes"/>
...
...
</xsl:stylesheet>

Örnek 2

Bu örnekte, çıktı HTML belgesidir, sürümü 4.0'dır. Karakter kodlama yöntemi "ISO-8859-1" olarak ayarlanmıştır, okunabilirliği artırmak için çıktı yuvarlanmıştır:

<?xml version="1.0" encoding="ISO-8859-1"?>
<xsl:stylesheet version="1.0"
xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
<xsl:output method="html" version="4.0" encoding="iso-8859-1" indent="yes"/>
...
...
</xsl:stylesheet>