عنصر XSLT <xsl:key>

دليل مرجع عنصر XSLT

التعريف والاستخدام

<xsl:key> هو عنصر سطح السطح، يمكنه إعلان مفتاح مسمى (بالاسم والقيمة للعناصر المحددة في وثيقة XML).

يستخدم هذا المفتاح من خلال دالة key() في جدول الأسلوب، لمساعدتك في الوصول بشكل فعال إلى العناصر المُنوطة بالعناصر في وثيقة XML المعقدة.

ملاحظة:لا يجب أن يكون المفتاح فريداً!

النحو

<xsl:key
name="name"
match="pattern"
use="expression"/>

الخاصية

الخاصية القيمة الوصف
name name مطلوب. تحديد اسم المفتاح.
match pattern مطلوب. تحديد النوع الذي سيطبق عليه المفتاح.
use expression

مطلوب. تحديد التعبير الذي سيتم استخدامه كقيمة للمفتاح.

يمكن أن يكون القيمة المفتاحية أي من القيم التالية: الخاصية أو عنصر الفرع أو محتوى العنصر المطابق.

مثال

مثال 1

افترض أن لديك ملف XML باسم "persons.xml":

<persons>
  <person name="Tarzan" id="050676"/>
  <person name="Donald" id="070754"/>
  <person name="Dolly" id="231256"/>
</persons>

يمكنك تعريف مفتاح في ملف XSL مثل هذا:

<xsl:key name="preg" match="person" use="@id"/>

لإيجاد person مع id="050676"، استخدم هذه الأكواد (في ملف XSL):

<?xml version="1.0" encoding="ISO-8859-1"?>
<xsl:stylesheet version="1.0"
xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
<xsl:key name="preg" match="person" use="@id"/>
<xsl:template match="/">
  <html>
  <body>
  <xsl:for-each select="key('preg','050676')">
    <p>
    الرقم التعريفي: <xsl:value-of select="@id"/><br />
    الاسم: <xsl:value-of select="@name"/>
    </p>
  </xsl:for-each>
  </body>
  </html>
</xsl:template>
</xsl:stylesheet>

دليل مرجع عنصر XSLT