다음을 통해 공유


<xsl:output> 요소

결과 트리를 직렬화하는 데 사용할 옵션을 지정합니다.

<xsl:output
  method = "xml" | "html" | "text" | QName
  version = nmtoken
  encoding = string
  omit-xml-declaration = "yes" | "no"
  standalone = "yes" | "no"
  doctype-public = string
  doctype-system = string
  cdata-section-elements = QNames
  indent = "yes" | "no"
  media-type = string
  />

특성

  • method
    결과 트리를 출력하는 데 사용되는 전체 메서드를 식별합니다. 접두사가 없을 경우 이 문서에 지정된 메서드를 식별합니다. 이 메서드는 "xml", "html", "text" 중 하나이거나 NCName이 아닌 정규화된 이름(QName)이어야 합니다. 접두사가 있을 경우 확장되며 출력 메서드를 식별합니다.

    method 특성의 기본값은 다음과 같이 선택됩니다. 다음 조건 중 하나라도 만족하면 기본 출력 메서드는 "html"입니다.

    • 결과 트리의 루트 노드에 요소 자식이 있을 경우

    • 결과 트리에서 루트 노드 즉, 문서 요소의 첫 번째 요소 자식의 확장 이름에 대/소문자에 상관없이 로컬 부분 "html"과 null 네임스페이스 URI가 있을 경우

    • 결과 트리에서 루트 노드의 첫 번째 요소 자식 앞의 텍스트 노드에 공백 문자만 포함된 경우

    그렇지 않으면 기본 출력 메서드는 "xml"입니다. <xsl:output> 요소가 없거나 <xsl:output> 요소에서 method 특성 값을 지정하지 않은 경우 기본 출력 메서드를 사용해야 합니다.

    XHTML을 출력하는 경우 "html" 대신 "xml"을 출력 메서드로 설정하는 것이 보다 효과적입니다.

  • version
    "xml" 출력 메서드와 관련하여 버전 1.0을 지정합니다. 이 특성은 출력 XML 선언에 <?xml version="1.0"?>으로 나타납니다.
  • encoding
    파서가 문자 시퀀스를 바이트 시퀀스로 인코딩할 때 사용해야 할 기본 설정 문자 인코딩을 지정합니다. 특성 값은 대/소문자를 구분하지 않고 처리되며 인쇄 가능한 ASCII 문자만 포함해야 합니다. 또한 등록된 문자 집합이거나 x-로 시작해야 합니다.
  • omit-xml-declaration
    XSLT 프로세서가 XML 선언을 출력하는지 여부를 지정합니다. 값은 yes 또는 no여야 합니다.
  • standalone
    XSLT 프로세서가 독립 실행형 문서 선언을 출력하는지 여부를 지정합니다. 값은 yes 또는 no여야 합니다.
  • doctype-public
    DTD에서 사용할 공용 식별자를 지정합니다.
  • doctype-system
    DTD에서 사용할 시스템 식별자를 지정합니다.
  • cdata-section-elements
    CDATA 섹션을 사용하여 텍스트 노드 자식을 출력해야 할 요소의 정규화된 이름 목록을 지정합니다.
  • indent
    결과 트리를 출력할 때 공백 추가 여부를 지정합니다. 값은 yes 또는 no여야 합니다.
  • media-type
    결과 트리를 출력한 결과로 나온 데이터의 미디어 형식(MIME 내용 형식)을 지정합니다.

요소 정보

발생 횟수

제한 없음

부모 요소

xsl:stylesheet, xsl:transform

자식 요소

자식 요소 없음

설명

스타일시트 하나에 여러 <xsl:output> 요소가 포함될 수 있으며 <xsl:output> 요소가 포함된 여러 스타일시트가 포함될 수도 있습니다. 스타일시트에서 발생하는 모든 <xsl:output> 요소는 효율적인 단일 <xsl:output> 요소에 병합됩니다. 특성 하나에 이러한 값이 둘 이상이면 오류가 발생합니다. 특성 값은 <xsl:output> 요소가 병합된 후 기본값으로 설정됩니다. 출력 메서드마다 한 특성에 대한 기본값이 다를 수 있습니다.

예제

다음 항목에서는 <xsl:output> 예제를 제공합니다.