files/en-us/web/api/xsltprocessor/transformtodocument/index.md
{{APIRef("DOM")}}
The transformToDocument() method of the {{domxref("XSLTProcessor")}} interface transforms the provided {{DOMxRef("Node")}} source to a {{domxref("Document")}} using the XSLT stylesheet associated with XSLTProcessor.
transformToDocument(source)
source
A {{domxref("Document")}}. The actual interface depends on the output method of the stylesheet, as specified by <xsl:output> element's method.
| Output method | Result interface |
|---|---|
html | {{domxref("HTMLDocument")}} |
xml | {{domxref("XMLDocument")}} |
text | {{domxref("XMLDocument")}} with a single root element <transformiix:result> with the text as a child |
This example demonstrates how to use transformToDocument() to transform an XML document using XSLT, resulting in a new XML document structure.
<pre id="result"></pre>
const xmlString = `
<books>
<book>
<title>Book 1</title>
<author>Author 1</author>
</book>
<book>
<title>Book 2</title>
<author>Author 2</author>
</book>
</books>
`;
const xsltString = `
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
<xsl:output method="xml" indent="yes"/>
<xsl:template match="/">
<catalog>
<xsl:for-each select="books/book">
<item>
<name><xsl:value-of select="title"/></name>
<writer><xsl:value-of select="author"/></writer>
</item>
</xsl:for-each>
</catalog>
</xsl:template>
</xsl:stylesheet>
`;
const parser = new DOMParser();
const xmlDoc = parser.parseFromString(xmlString, "application/xml");
const xsltDoc = parser.parseFromString(xsltString, "application/xml");
const xsltProcessor = new XSLTProcessor();
xsltProcessor.importStylesheet(xsltDoc);
// Perform the transformation, returning the result as a new XML document
const resultDoc = xsltProcessor.transformToDocument(xmlDoc);
// Serialize the result document to a string
const serializer = new XMLSerializer();
const resultString = serializer.serializeToString(resultDoc);
// Display the transformed XML in the page
document.getElementById("result").textContent = resultString;
{{EmbedLiveSample("using_transformToDocument", "", "200")}}
{{Specifications}}
{{Compat}}