XSLT <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 선택 가능. 출력에서 인코딩 속성의 값을 설정합니다.
omit-xml-declaration
  • yes
  • no

선택 가능.

"yes"는 출력에서 XML 선언을 생략합니다 (<?xml...?>).

"no"는 출력에 XML 선언을 포함하도록 규정합니다. 기본 값은 "no"입니다.
standalone
    • yes
    • no
 선택 가능. XSLT 처리기가 독립 문서 선언을 출력해야 하는지 결정합니다; 이 값은 yes 또는 no여야 합니다. 기본 값은 "no"입니다. Netscape 6는 이 속성을 지원하지 않습니다.
doctype-public string 선택 사항입니다. DTD에서 사용할 공통 식별자를 정의합니다. 즉, 출력 중 DOCTYPE 선언의 PUBLIC 속성 값입니다。
doctype-system string 선택 사항입니다. DTD에서 사용할 시스템 식별자를 정의합니다. 즉, 출력 중 DOCTYPE 선언의 SYSTEM 속성 값입니다。
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를 포함합니다。

결과 트리의 루트 노드의 첫 번째 요소 자식 이전의 모든 텍스트 노드는 공백 문자만 포함합니다。

그렇지 않으면, 기본 출력 방법은 "xml"입니다. <xsl:output> 요소가 없거나 <xsl:output> 요소가 method 속성 값을 지정하지 않았을 경우, 기본 출력 방법을 사용해야 합니다。

예제

예제 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 요소