تابع key() XSLT

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

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

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

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

نحوه استفاده

نمونه‌جمعیتی key(string, object)

پارامتر

پارامتر توضیح
رشته ضروری. نام 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>
  Title: <xsl:value-of select="title" />
  <br />
  Artist: <xsl:value-of select="artist" />
  <br />
  قیمت: <xsl:value-of select="price" />
  </p>
</xsl:for-each>
</body>
</html>
</xsl:template>
</xsl:stylesheet>

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