องค์ประกอบ <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 เลือกได้ กำหนดค่าของ attribute encoding ในออก
omit-xml-declaration
  • yes
  • no

เลือกได้

"yes" กำหนดให้ละเลยคำแถลงการเปิด XML (<?xml...?>) ในออก

"no" กำหนดให้รวมคำแถลงการเปิด XML ในออก; โดยมาตรฐานเป็น "no"
standalone
    • yes
    • no
 เลือกได้ กำหนดว่า XSLT ตัวปฏิบัติการจะออกคำแถลงการเปิดเอกสารเดี่ยว; ค่าต้องเป็น yes หรือ no โดยมาตรฐานเป็น "no" โดย Netscape 6 ไม่สนับสนุน attribute นี้
doctype-public string เลือกได้ กำหนดรหัสสาธารณะที่ใช้ใน DTD หรือค่าของ attribute PUBLIC ใน DOCTYPE ของออก:
doctype-system string เลือกได้ กำหนดรหัสระบบที่ใช้ใน DTD หรือค่าของ attribute SYSTEM ใน DOCTYPE ของออก:
cdata-section-elements namelist เลือกได้ รายชื่อขององค์ประกอบแบบชุด ขององค์ประกอบที่มีข้อความจะถูกออกเป็นส่วนของ CDATA:
indent
  • yes
  • no
 เลือกได้ กำหนดว่าจะเพิ่มช่องว่างหรือไม่ในต้นไม้ผลลัพธ์ที่ออก ค่าต้องเป็น yes หรือ no โดย Netscape 6 ไม่สนับสนุน attribute นี้
media-type string เลือกได้ กำหนดรูปแบบ MIME ของการออก (รูปแบบสื่อของข้อมูล) โดยมาตรฐานเป็น "text/xml" โดย Netscape 6 ไม่สนับสนุน attribute นี้

attribute method

รหัสที่ใช้สำหรับการออกเป็นแบบทั้งหมดของต้นไม้ผลลัพธ์ หากไม่มี prefix ในรหัสนี้ ต้องเป็นวิธีที่ระบุในเอกสารนี้ ต้องเป็น "xml" หรือ "html" หรือ "text" หรือ รหัสที่ไม่ใช่ NCName: หากมี prefix ในรหัสนี้ ต้องขยายและระบุวิธีออกเป็นแบบ:

การเลือกค่าของ attribute method โดยมาตรฐานตามต่อไปนี้ หากใดๆ ในเงื่อนไขดังนี้เป็นความจริง วิธีออกเป็นแบบที่เรียกว่า "html":

เศษรากในต้นไม้ผลลัพธ์มีองค์ประกอบเศษราก:

ชื่อเพิ่มเติมของเศษรากในต้นไม้ผลลัพธ์ที่เป็นเศษรากที่แรกขององค์ประกอบอาจมีชื่อท้องถิ่น "html" (ใช้กำหนดให้เป็นขาดหรือมีมากกว่านี้) และ URI ชื่ออากาศ:

ข้อความที่อยู่ก่อนหน้านี้ของเศษรากในต้นไม้ผลลัพธ์มีเพียงแค่อักษรหรืออากาศ:

ถ้าไม่มี <xsl:output> หรือ <xsl:output> ที่ระบุค่าของ attribute method จะต้องใช้วิธีออกเป็นแบบที่เรียกว่า "xml" โดยมาตรฐาน

ตัวอย่าง

ตัวอย่าง 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