องค์ประกอบ <xsl:output> ของ 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 ใช้งานตามความต้องการ ตั้งค่าค่าของคุณสมบัติ encoding ในการออกผลลัพธ์
omit-xml-declaration
  • yes
  • no

ใช้งานตามความต้องการ

"yes" กำหนดว่าต้องละคำแถลงเอกสาร XML (<?xml...?>) ในการออกผลลัพธ์

"no" กำหนดว่าควรมีคำแถลงเอกสาร XML ในการออกผลลัพธ์

standalone
    • yes
    • no
ใช้งานตามความต้องการ กำหนดว่า XSLT ได้เขียนคำแถลงเอกสาร XML อิสระหรือไม่; ค่าต้องเป็น yes หรือ no โดยเริ่มต้นค่าเป็น "no" โดย 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" (ทุกวิธีใช้ตัวเล็กหรือตัวใหญ่) และ URI ชื่อสเปซ์ว่าง

ข้อความที่อยู่ก่อนหน้าสาขาลูกแรกของต้นกิ่งหลักของต้นตรงของผลลัพธ์มีเพียงแต่อักษรวรรษฐ์ที่เป็นช่องว่าง

ถ้าไม่มี <xsl:output> หรือ <xsl:output> ไม่มีค่าที่ระบุคำว่า 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>