blockly > utils > xml

Namespace „utils.xml“

Funktionen

Funktion Beschreibung
createElement(tagName) DOM-Element für XML erstellen
createTextNode(text) Erstellt ein Textelement für XML.
domToText(dom)

Wandelt eine DOM-Struktur in Nur-Text um. Derzeit ist das Textformat ziemlich unschön: Es gibt eine Zeile ohne Leerzeichen.

Steuerzeichen werden mit ihrer Dezimalcodierung maskiert. Dazu gehört U+0000, obwohl es eigentlich nie ein gültiges XML-Zeichen ist (auch in XML 1.1). https://www.w3.org/TR/xml11/#charsets

Bei der Decodierung wird U+0000 als U+FFFD (das „Ersatzzeichen“) geparst.

injectDependencies(dependencies)

Fügen Sie Implementierungen von document, DOMParser und/oder XMLSerializer zur Verwendung anstelle der Standardimplementierungen ein.

Wird vom Node.js-Wrapper für Blockly (siehe Skripts/package/node/core.js) verwendet, um stattdessen Implementierungen aus dem jsdom-Paket bereitzustellen.

Auch wenn sie einzeln festgelegt werden können, stammen normalerweise alle drei von derselben JSDOM-Instanz. Sie MÜSSEN zumindest aus der gleichen Kopie des JSdom-Pakets stammen. In der Regel lässt sich dies nur schwer vermeiden. Es kann jedoch versehentlich verletzt werden, wenn Webpack verwendet wird, um mehrere Bundles mit Blockly und JSdom zu erstellen und dann mehrere in dieselbe JavaScript-Laufzeit zu laden. Ein Beispiel dafür finden Sie unter https://github.com/google/blockly-samples/pull/1452#issuecomment-1364442135.

textToDom(Text)

Wandelt einen XML-String in eine DOM-Struktur um.

Steuerzeichen müssen maskiert werden. Wir versuchen jedoch, Zeichen ohne Escape-Angabe bestmöglich zu parsen.

Auch im Escape-Format wird U+0000 als U+FFFD (das „Ersatzzeichen“) geparst, weil U+0000 nie ein gültiges XML-Zeichen ist (auch in XML 1.1). https://www.w3.org/TR/xml11/#charsets

Variablen

Variable Beschreibung
NAME_SPACE Namespace für die XML-Datei von Blockly