共用方式為


<xsl:value-of> 元素

將所選節點的值做為文字插入。

<xsl:value-of
  select = Expression
  disable-output-escaping = "yes" | "no" 
</xsl:value-of>

屬性

  • select
    必要項。 要針對目前的內容評估的 Expressions (XSLT)。 結果會在呼叫 string() 函式後轉換為字串。 藉由在節點集中插入第一個節點的字串值,節點集可轉換為字串。

  • disable-output-escaping
    預設值為 "no"。 如果值為 "yes",則會輸出藉由具現化 <xsl:value-of> 項目所產生的文字節點,而不會包含任何逸出。 例如,下列程式碼將會產生單一字元 "<"。

    <xsl:value-of disable-output-escaping="yes" select="string('&lt;')"/>
    
    注意事項注意事項

    因為 disable-output-escaping="yes" 會產生格式不正確的文件,必須小心使用。格式不正確的輸出可能會在特定情況下產生錯誤。例如,對 XML 文件執行 transformNodeToObject 需要格式正確的結果,所以當 disable-output-escaping 已影響到文件的格式正確性時,就可能無法完成這個動作。請將 disable-output-escaping="yes" 視為進階功能,只有在充分瞭解可能的風險時,才能加以使用。

項目資訊

發生次數

無限制

父項目

xsl:attributexsl:commentxsl:copyxsl:elementxsl:fallbackxsl:for-eachxsl:ifxsl:messagexsl:otherwisexsl:paramxsl:processing-instructionxsl:templatexsl:variablexsl:whenxsl:with-param、輸出項目

項目子系

(沒有項目子系)

備註

<xsl:value-of> 項目會插入文字字串,代表 select 屬性為第一個項目 (依文件順序) 所指定的值。

若 XML 路徑語言 (XPath) 運算式傳回多個節點,<xsl:value-of> 項目就會傳回第一個傳回之節點的文字 (等同於 XMLDOMNode 物件的 selectSingleNode 方法)。 若傳回的節點是含有子結構的項目,則 <xsl:value-of> 會傳回該項目之子樹狀目錄的串連文字節點,其中不含標記。

範例

下列 XSLT 檔案會由 <person> 項目中,利用 <given-name> 及 <family-name> 項目子系來建立 <p> 項目。 <p> 項目將含有目前節點的第一個 <given-name> 項目子系的字串值,其後是空格,最後是目前節點的第一個 <family-name> 項目子系的字串值。

XML 檔 (family.xml)

<?xml version="1.0"?>
<?xml-stylesheet type="text/xsl" href="family.xsl"?>
<family>
  <person>
    <given-name age="10">Fred</given-name>
    <family-name>Smith</family-name>
  </person>
  <person>
    <given-name age="13">Jill</given-name>
    <family-name>Jones</family-name>
  </person>
</family>

XSLT 檔 (family.xsl)

<?xml version='1.0'?>
<xsl:stylesheet version="1.0"
      xmlns:xsl="http://www.w3.org/1999/XSL/Transform">

<xsl:template match="person">
  <p>
    <xsl:value-of select="given-name"/>
    <xsl:text> </xsl:text>
    <xsl:value-of select="family-name"/>
  </p>
</xsl:template>

</xsl:stylesheet>

輸出

此為格式化輸出:

Fred Smith

Jill Jones

此為處理器輸出:

<?xml version="1.0" encoding="UTF-16"?>
  <p>Fred Smith</p>
  <p>Jill Jones</p>