تابع key() XSLT

دستورالعمل‌های مرجع عناصر XSLT

تعریف و نحوه استفاده

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

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

به عنصر <xsl:key> مراجعه کنید.

نحوه استفاده

node-set کلید(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 را مشاهده کنید,نتیجه را مشاهده کنید.

دستورالعمل‌های مرجع عناصر XSLT