Stay organized with collections
Save and categorize content based on your preferences.
blockly > utils > xml > textToDom
utils.xml.textToDom() function
Converts an XML string into a DOM structure.
Control characters should be escaped. (But we will try to best-effort parse unescaped characters.)
Note that even when escaped, U+0000 will be parsed as U+FFFD (the "replacement character") because U+0000 is never a valid XML character (even in XML 1.1). https://www.w3.org/TR/xml11/#charsets
Signature:
export declare function textToDom(text: string): Element;
Parameters
| Parameter |
Type |
Description |
| text |
string |
An XML string. |
Returns:
Element
A DOM object representing the singular child of the document element.
Exceptions
if the text doesn't parse.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2024-09-18 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2024-09-18 UTC."],[[["The `utils.xml.textToDom()` function transforms an XML string into a DOM structure, facilitating interaction with XML data within Blockly applications."],["It prioritizes escaped control characters for optimal parsing but attempts to handle unescaped characters gracefully, with the exception of U+0000 which is always replaced with U+FFFD due to XML standards."],["The function accepts an XML string as input and returns a DOM element representing the singular child of the document element, throwing an exception if parsing fails."]]],[]]
