عنصر <xsl:message> XSLT

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

عنصر <xsl:message> یک پیام را به خروجی می‌نویسد. این عنصر معمولاً برای گزارش خطا استفاده می‌شود.

این عنصر می‌تواند تقریباً هر عنصر دیگر XSL را شامل شود (<xsl:text>، <xsl:value-of> و غیره).

ویژگی terminate به شما اجازه می‌دهد انتخاب کنید که در صورت بروز خطا، آیا باید تبدیل متوقف شود یا خیر.

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

<xsl:message terminate="yes|no">
  <!-- Content:template -->
</xsl:message>

ویژگی

ویژگی مقدار توضیح
terminate
  • yes
  • no
اختیاری. "yes": در حالت نوشتن پیام به خروجی، فرآیند متوقف می‌شود. "no": در حالت نوشتن پیام به خروجی، فرآیند ادامه می‌یابد. پیش‌فرض "no" است.

مثال

مثال 1

مقابلة artist آیا خالی است یا خیر. اگر بله، خروج از پردازش XSL و نمایش یک پیام.

<?xml version="1.0" encoding="ISO-8859-1"?>
<xsl:stylesheet version="1.0"
xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
<xsl:template match="/">
  <html>
  <body>
  <xsl:for-each select="catalog/cd">
    <p>عنوان: <xsl:value-of select="title"/><br />
    آرٹسٹ:
    <xsl:if test="artist=''">
      <xsl:message terminate="yes">
        ایرور: آرٹسٹ خالی جملہ ہے!
      </xsl:message>
    </xsl:if>
    <xsl:value-of select="artist"/>
    </p>
  </xsl:for-each>
  </body>
  </html>
</xsl:template>
</xsl:stylesheet>