XSLT 元素

定义和用法

元素定义了输出文档的格式。

注释: 是顶层元素(top-level element),必须是 的子节点。

语法


属性

属性 描述
method
  • xml
  • html
  • text
  • name
可选。定义输出的格式。默认是 XML。Netscape 6 仅支持 "html" 和 "xml"。
version string 可选。设置输出格式的 W3C 版本号。(仅在 method="html" or method="xml" 时使用)。
encoding string 可选。设置输出中编码属性的值。
omit-xml-declaration
  • yes
  • no

可选。

"yes" 规定在输出中省略 XML 声明 ()。

"no" 规定应在输出中包含 XML 声明。默认是 "no"。

standalone
    • yes
    • no
可选。规定 XSLT 处理器是否应输出独立文档声明;该值必须为 yes 或 no。默认是 "no"。Netscape 6 不支持该属性。
doctype-public string اختیاری. مشخص می‌کند که شناسه‌ی عمومی باید در DTD استفاده شود. این شناسه ارزش attribute属性的 PUBLIC مستند خروجی است.
doctype-system string اختیاری. مشخص می‌کند که شناسه‌ی سیستم باید در DTD استفاده شود. این شناسه ارزش attribute属性的 SYSTEM مستند خروجی است.
cdata-section-elements namelist اختیاری. لیستی از عناصر جدا شده با فضای خالی است که باید به عنوان بخش CDATA خروجی شوند.
indent
  • yes
  • no
اختیاری. مشخص می‌کند که آیا باید فضاهای خالی اضافی در خروجی نتایج درخت اضافه شود یا خیر؛ این ارزش باید "yes" یا "no" باشد. Netscape 6 این attribute را پشتیبانی نمی‌کند.
media-type string اختیاری. نوع MIME خروجی را تعریف می‌کند (نوع رسانه‌ی داده‌ها). پیش‌فرض "text/xml" است. Netscape 6 این attribute را پشتیبانی نمی‌کند.

attribute属性的 method

شناسه‌ای برای شناسایی روش کلی خروجی نتایج درخت است. اگر هیچ پیشوندی وجود نداشته باشد، شناسه‌ای که در مستند مشخص شده است، باید "xml"، "html"، "text" یا یکی از نام‌های限定 نشده‌ی NCName باشد). اگر پیشوند وجود داشته باشد، آن را باز کرده و شناسایی کنید.

انتخاب ارزش پیش‌فرض attribute属性的 method به شرح زیر است. اگر هر یک از شرایط زیر صحیح باشد، روش خروجی پیش‌فرض "html" خواهد بود:

نقطه‌ی ریشه‌ی درخت نتایج شامل زیرعناصر عناصر است.

نام‌دهی توسعه‌یافته‌ی اولین زیرعنصر عناصر ریشه‌ی نتایج درخت شامل بخش محلی "html" (در هر ترکیب از حروف بزرگ و کوچک) و URI نام‌گذاری شده است.

هر نقطه‌ی متنی که قبل از اولین زیرعنصر عناصر ریشه‌ی نتایج درخت فقط شامل کاراکترهای خالی است.

در غیر این صورت، روش خروجی پیش‌فرض "xml" است. اگر هیچ عنصر <xsl:output> وجود نداشته باشد یا اگر هیچ عنصر <xsl:output> روش attribute属性的 value را تعیین نکرده باشد، باید از روش خروجی پیش‌فرض استفاده شود.

مثال

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