عنصر <xsl:output> XSLT

دستورالعمل مرجع عناصر XSLT

تعریف و استفاده

عنصر <xsl:output> قالب خروجی مستند را تعریف می‌کند.

نکته:<xsl:output> یک عنصر سطح بالا (top-level element) است و باید فرزند <xsl:stylesheet> یا <xsl:transform> باشد.

منطق

<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"/>

ویژگی

ویژگی مقدار توضیحات
method
  • xml
  • html
  • متن
  • نام
 اختیاری. تعریف قالب خروجی. پیش‌فرض XML است. Netscape 6 تنها از "html" و "xml" پشتیبانی می‌کند.
نسخه string اختیاری. تنظیم نسخه W3C از قالب خروجی. (فقط در method="html" یا method="xml" استفاده می‌شود).
encoding string اختیاری۔ آؤٹ میں کدنگ کا اپنائی جانے والا حصہ کا تعین کرنا۔
omit-xml-declaration
  • yes
  • no

اختیاری۔

"yes" یعنی آؤٹ میں XML اعلانی کو چھوڑ دیا جانا چاہئے (<?xml...?>)۔

"no" یعنی آؤٹ میں XML اعلانی کا شامل کیا جانا چاہئے۔ پیش فرض "no" ہے۔
standalone
    • yes
    • no
 اختیاری۔ XSLT پروسیسر کو مستقل ڈوکومنٹ اعلانی کا آؤٹ کرنا یا نہ کرنا کا تعین کرنا، اس کا اپنائی جانے والا حصہ yes یا no کا شامل ہوتا ہے؛ پیش فرض "no" ہے۔ Netscape 6 اس اپنائی جانے والا حصہ کو نہیں دعومت دیتا۔
doctype-public string اختیاری۔ DTD میں استعمال کی جانے والی مشترک شناختی کا تعین کرنا، یعنی آؤٹ میں DOCTYPE اعلانی کی PUBLIC کا اپنائی جانے والا حصہ کا شامل ہوتا ہے۔
doctype-system string اختیاری۔ DTD میں استعمال کی جانے والی سسٹم شناختی کا تعین کرنا، یعنی آؤٹ میں DOCTYPE اعلانی کی SYSTEM کا اپنائی جانے والا حصہ کا شامل ہوتا ہے۔
cdata-section-elements namelist اختیاری۔ ایک سپراس کی جانب سے منفرد علامت فرزند کا فہرست، جس کا تکسٹ کا شامل کی جانا چاہئے CDATA حصہ کی طرح، آؤٹ میں کیا جانا چاہئے۔
indent
  • yes
  • no
 اختیاری۔ آؤٹ کا نتائج کا درخت کی چارکٹوں کا اضافہ کیا جانا یا نہ کیا جانا، اس کا اپنائی جانے والا حصہ yes یا no کا شامل ہوتا ہے؛ Netscape 6 اس اپنائی جانے والا حصہ کو نہیں دعومت دیتا۔
media-type string اختیاری۔ آؤٹ کا MIME نوع (دیتا کا میڈیا نوع) کا تعین کرنا۔ پیش فرض "text/xml" ہے۔ Netscape 6 اس اپنائی جانے والا حصہ کو نہیں دعومت دیتا۔

method کا اپنائی جانے والا حصہ

ایکدوسر کا شناخت کرنا، جو کا استعمال نتائج کا درخت کا کل میتود کا شناخت کرنا چاہئے۔ اگر کوئی پچھلائی نہ ہو، اس ڈوکومنٹ میں کا شناخت کیا جانا چاہئے، جو "xml"، "html"، "text" یا NCName کا نام نہ ہو، اس کا استعمال کیا جانا چاہئے)۔ اگر پچھلائی ہو، تو اس کو کھولنا اور استعمال کیا جانا چاہئے۔

method کا پیش فرض کا اپنائی جانے والا حصہ کا انتخاب مندرجہ بالا ہے۔ اگر درج شدہ کوئی بھی شرط صحیح ہو، پیش فرض کا آؤٹ میتود "html" ہوگا:

نتائج کا درخت میں ریشه کا پہلا علامت فرزند شامل ہوتا ہے۔

نتائج کا درخت میں ریشه کا پہلا علامت فرزند (یعنی ڈوکومنٹ علامت) کی توسیع کا نام شامل لوکال حصہ "html" (کسی بھی بولی میں) اور خالی نام فضائی URI کا شامل ہوتا ہے۔

نتائج کا درخت میں ریشه کا پہلا علامت فرزند سے پہلے کی کسی بھی تکسٹ فرزند کو صرف خالی چارکٹوں کا شامل ہوتا ہے۔

درآمد، پیش فرض کا آؤٹ میتود "xml" ہے۔ اگر کوئی <xsl:output> علامت نہ ہو یا اگر کوئی <xsl:output> علامت کو method کا اپنائی جانے والا حصہ نہ دیا گیا ہو، پیش فرض کا آؤٹ میتود استعمال کیا جانا چاہئے۔

مثال

مثال 1

یہ مثال میں، آؤٹ XML ڈوکومنٹ ہے، ورژن 1.0 ہے۔ چارکٹ کدنگ طریقہ کار کو "ISO-8859-1" رکھا گیا ہے، آؤٹ کو سکیند سے آگاہی میں بہتر بنانے کیلئے سکیند دیا گیا ہے:

<?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>

مثال 2

در این مثال، خروجی یک مستند HTML است، نسخه 4.0. روش کدگذاری کاراکتر به "ISO-8859-1" تنظیم شده است، خروجی فاصله‌گذاری خواهد شد تا خوانایی بهبود یابد:

<?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>

دستورالعمل مرجع عناصر XSLT