عنصر 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