عنصر <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
  • text
  • name
 اختیاری. فرمت خروجی را تعریف می‌کند. پیش‌فرض XML است. Netscape 6 تنها "html" و "xml" را پشتیبانی می‌کند.
version 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