องค์ประกอบ <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 โดย Netscape 6 สนับสนุน "html" และ "xml" |
version | string | ใช้งานตามความต้องการ ตั้งค่าเลขรุ่นของ W3C ของรูปแบบออกผลลัพธ์ (ใช้เมื่อ method="html" หรือ method="xml") |
encoding | string | ใช้งานตามความต้องการ ตั้งค่าค่าของคุณสมบัติ encoding ในการออกผลลัพธ์ |
omit-xml-declaration |
|
ใช้งานตามความต้องการ "yes" กำหนดว่าต้องละคำแถลงเอกสาร XML (<?xml...?>) ในการออกผลลัพธ์ "no" กำหนดว่าควรมีคำแถลงเอกสาร XML ในการออกผลลัพธ์ |
standalone |
|
ใช้งานตามความต้องการ กำหนดว่า 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 ที่ 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>