XSLT <xsl:output> ögesi
Tanım ve Kullanım
<xsl:output> ögesi çıktı belgesinin formatını tanımlar.
Yorum:<xsl:output> üst düzey bir öğedir (top-level element) ve <xsl:stylesheet> veya <xsl:transform>'nın alt öğesi 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 | tanım |
|---|---|---|
| method |
|
İsteğe bağlı. Çıktı formatını tanımlar.Varsayılan XML'dir. Netscape 6 yalnızca "html" ve "xml" destekler. |
| version | string | İsteğe bağlı. Çı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 |
|
Opsiyonel. "yes" çıktıya XML bildirimini içermez (<?xml...?>). "no" çıktıya XML bildirimini içerir. Varsayılan "no" olarak belirlenmiştir. |
| standalone |
|
Opsiyonel. XSLT işleyicisinin bağımsız belge bildirimi çıkarıp çıkarılmayacağını belirtir; bu değer yes veya no olmalıdır. Varsayılan "no" olarak belirlenmiştir. Netscape 6 bu özelliği desteklememektedir. |
| doctype-public | string | Opsiyonel. DTD'de kullanılacak ortak tanımlayıcısını belirtir. Yani çıktıdaki DOCTYPE bildiriminde PUBLIC özelliğinin değeri. |
| doctype-system | string | Opsiyonel. DTD'de kullanılacak sistem tanımlayıcısını belirtir. Yani çıktıdaki DOCTYPE bildiriminde 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ıya sunulmalıdır. |
| indent |
|
Opsiyonel. Çıktı ağacını oluştururken boşluk eklenip eklenmemesi gerektiğini belirtir; bu değer yes veya no olmalıdır. Netscape 6 bu özelliği desteklememektedir. |
| media-type | string | Opsiyonel. Çıktıya sunulacak MIME türünü tanımlar (verilerin medya türü). Varsayılan "text/xml" olarak belirlenmiştir. Netscape 6 bu özelliği desteklememektedir. |
method özelliği
Sonuç ağacını çıkaracak genel yöntemi tanımlayan bir tanımlayıcıdır. Önek yoksa, bu belgede belirtilen yöntemi tanımlar, "xml", "html", "text" veya NCName olmayan bir sınırlayıcı ad olmalıdır). Önek varsa, açılır ve çıktı yöntemini tanımlar.
method özelliğinin varsayılan değerinin seçimi aşağıdaki gibi görünüyor. Eğer aşağıdaki herhangi bir koşul doğruysa, varsayılan çıktı yöntemi "html" olarak belirlenir:
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. (Yani belge elementi) Genişletilmiş adı yerel bir parça "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ündeki herhangi bir metin düğümü sadece boş karakterler içerir.
Aksi takdirde, varsayılan çıktı yöntemi "xml" olarak belirlenmiştir. Eğer <xsl:output> ögesi yoksa veya <xsl:output> ögesi method özelliği belirtilmemişse, varsayılan çıktı yöntemini kullanmalısınız.
Ö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ı yatayca daraltılmış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'tur. Karakter kodlama yöntemi "ISO-8859-1" olarak ayarlanmıştır, çıktı daraltılarak okunabilirliği artırılmış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>
