<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('<')"/>
注意事項 因為 disable-output-escaping="yes" 會產生格式不正確的文件,必須小心使用。格式不正確的輸出可能會在特定情況下產生錯誤。例如,對 XML 文件執行 transformNodeToObject 需要格式正確的結果,所以當 disable-output-escaping 已影響到文件的格式正確性時,就可能無法完成這個動作。請將 disable-output-escaping="yes" 視為進階功能,只有在充分瞭解可能的風險時,才能加以使用。
項目資訊
發生次數 |
無限制 |
父項目 |
xsl:attribute、xsl:comment、xsl:copy、xsl:element、xsl:fallback、xsl:for-each、xsl:if、xsl:message、xsl:otherwise、xsl:param、xsl:processing-instruction、xsl:template、xsl:variable、xsl:when、xsl: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>