XSLT key() funktio

määrittely ja käyttö

key() funktio palauttaa solmujoukon käyttämällä <xsl:key> elementissä määriteltyä indeksiä.

key() funktio hakee solmujoukon, joka on sama kuin <xsl:key> lausekkeessa määritetty avainnimi ja -arvo (nolla tai useita solmuja). Kun käsitellään ensimmäistä kertaa XSLT-tyyletsiä, avain tallennetaan sisäisesti, mikä yksinkertaistaa pääsyä. Avain voi yksinkertaistaa solmujen pääsyä XML-dokumenttiin, mutta se ei ehkä ole nopeampi kuin XPath:n käyttö samojen solmujen hakemiseen.

katso <xsl:key> elementti.

syntaksi

node-set key(string, objekti)

parametri

parametri kuvaus
merkkijono pakollinen. Määrittää xsl:key-elementin nimi.
objekti pakollinen. Haettava merkkijono.

esimerkki

<?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>
  Otsikko: <xsl:value-of select="title" />
  <br />
  Artisti: <xsl:value-of select="artist" />
  <br />
  Hinta: <xsl:value-of select="price" />
  </p>
</xsl:for-each>
</body>
</html>
</xsl:template>
</xsl:stylesheet>

Tarkista XSL-tiedosto,Tarkista XSL-tiedosto,Tarkista tulokset.