다음을 통해 공유

<xsl:key> 요소

  • 아티클

<xsl:key> 요소는 명명된 키를 선언합니다. 즉, XML 문서에서 지정된 요소에 할당된 이름 값 쌍을 선언합니다. XPath 식에서 이 키와 key() 함수를 함께 사용하면 복합 XML 문서에서 지정된 요소에 효과적으로 액세스할 수 있습니다.

<xsl:key
  name = QName
  match = Pattern
  use = Expression
</xsl:key>

특성

  • match
    이 키를 보유하고 있는 노드를 식별하는 패턴을 지정합니다.
  • use
    키 값으로 사용할 식을 지정합니다. 키 값은 일치하는 요소의 특성, 자식 요소, 내용 중 하나일 수 있습니다.

요소 정보

발생 횟수

제한 없음

부모 요소

xsl:stylesheet

자식 요소

자식 요소 없음

설명

키를 일반화된 ID로 사용하여 XML 문서에서 요소를 참조할 수 있습니다. 이 작업을 수행하려면 먼저 <xsl:key>를 사용하여 노드에 대한 키를 선언합니다. 그런 다음 함수 인수로 키 이름과 값을 입력하여 key() 함수를 호출하고 노드를 검색합니다. 자세한 내용은 아래 예제를 참조하십시오.

노드 하나에 여러 키를 선언할 수 있습니다. 그러면 여러 가지 방법으로 노드를 쿼리할 수 있습니다.

비교적 큰 XML 문서에서 작업할 경우 키를 사용하면 신속하게 요소를 쿼리할 수 있습니다. 이는 키가 기본적으로 원하는 노드의 위치를 미리 인덱싱하기 때문입니다. 그러나 <xsl:key> 요소를 컴파일하는 경우 키에 대해 key() 함수를 호출하지 않으면 XSLT 프로세서에서 이러한 인덱스를 만들지 않습니다. 그러므로 시간이 많이 소요되는 인덱싱 작업은 반드시 필요한 경우에만 수행됩니다.

스타일시트에서 <xsl:key> 요소는 최상위 요소이며 템플릿 내에 나타날 수 없습니다. 순환 참조를 방지하기 위해 일치하는 <xsl:key>의 일부로 매개 변수나 변수 참조를 사용할 수 없습니다.

예제

다음 항목에서는 <xsl:key> 요소의 예제를 제공합니다.