توابع key() XSLT

تعريف و نحوه‌ي استفاده

توابع key() از طريق شماره‌ي شاخص مشخص شده توسط عنصر <xsl:key> مجموعه‌اي از نودها را از سند باز مي‌گرداند.

توابع key() جستجوي مجموعه‌اي از نودهايي است كه با نام و مقدار کلید مشخص شده در دستور <xsl:key> مطابقت دارند (هيچ نود يا چند نود). در اولين باري كه صفحه XSLT پردازش مي‌شود، کلید در داخل ذخيره خواهد شد تا دستيابي به آن آسان شود. کلید مي‌تواند دستيابي به نودهاي XML را ساده کند، اما ممکن است از استفاده از XPath براي جستجوي همان نودها سريع‌تر نباشد.

مطالعه <xsl:key> عنصر.

نحوه‌ي استفاده

نمونه‌گذاري node-set key(string, عنصر)

پارامتر

پارامتر توضيح
رشته ضروري. نام عنصر xsl:key مشخص مي‌کند.
عنصر ضروري. رشته‌اي كه بايد جستجو شود.

مثال

<?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="cdlist" match="cd" use="title" />
<xsl:template match="/">
<html>
<body>
<xsl:for-each select="key('cdlist', 'Empire Burlesque')">
  <p>
  عنوان: <xsl:value-of select="title" />
  <br />
  هنرمند: <xsl:value-of select="artist" />
  <br />
  قیمت: <xsl:value-of select="price" />
  </p>
</xsl:for-each>
</body>
</html>
</xsl:template>
</xsl:stylesheet>

فایل XSL را مشاهده کنید,فایل XSL را مشاهده کنید,نتایج را مشاهده کنید.