عنصر <xsl:message> XSLT

عناصر 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>Title: <xsl:value-of select="title"/><br />
    Artist:
    <xsl:if test="artist=''">
      <xsl:message terminate="yes">
        خطا: Artist یک رشته خالی است!
      </xsl:message>
    </xsl:if>
    <xsl:value-of select="artist"/>
    </p>
  </xsl:for-each>
  </body>
  </html>
</xsl:template>
</xsl:stylesheet>

عناصر XSLT