عنصر <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

اختياري.

"نعم" يحدد تجنب إعلان XML في الإخراج (<?xml...?>).

"لا" يحدد أن يتم تضمين إعلان XML في الإخراج. القيمة الافتراضية هي "لا".
standalone
    • yes
    • no
 اختياري. يحدد ما إذا كان معالج XSLT يجب عليه إخراج إعلان مستند مستقل؛ يجب أن يكون هذا القيمة "نعم" أو "لا". القيمة الافتراضية هي "لا". لا يدعم Netscape 6 هذه الخاصية.
doctype-public string اختياري.يحدد المعرف المشترك الذي يجب استخدامه في DTD.وهو قيمة الخاصية PUBLIC في بيان DOCTYPE في الإخراج.
doctype-system string اختياري.يحدد المعرف النظام الذي يجب استخدامه في DTD.وهو قيمة الخاصية SYSTEM في بيان DOCTYPE في الإخراج.
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" (بأي ترتيب من الأحرف الكبيرة أو الصغيرة) وليس له مسمى مساحة.

كل نود نصي قبل أول فرع للاعتماد الأول للعنصر الجذر في شجرة الناتج يحتوي فقط على مسافات بيضاء.

إذا لم يكن لديك طريقة إخراج افتراضية هي "xml".إذا لم يكن لديك عنصر <xsl:output> أو لم يتم تعيين قيمة الخاصية method لعنصر <xsl:output>،فينبغي استخدام طريقة الإخراج الافتراضية.

مثال

مثال 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