blockly > utils > xml

utils.xml 命名空間

函式

函式 說明
createElement(tagName) 為 XML 建立 DOM 元素。
createTextNode(text) 建立 XML 的文字元素。
domToText(dom)

將 DOM 結構轉換為純文字。目前文字格式有很高難度:一行都沒有空白字元。

控製字元會使用十進位編碼逸出。這包括 U+0000,即使理論上並沒有有效的 XML 字元 (即使在 XML 1.1 中也一樣)。https://www.w3.org/TR/xml11/#charsets

解碼的 U+0000 會剖析為 U+FFFD (「替代字元」)。

injectDependencies(dependencies)

插入使用文件、DOMParser 和/或 XMLSerializer 的實作,而非預設文件。

由 Blockly 的 Node.js 包裝函式使用 (請參閱指令碼/package/node/core.js),以便改為從 jsdom 套件提供實作。

雖然這些參數可以個別設定,但通常都會來自同一個 JSDOM 執行個體。至少要來自同一個 jsdom 套件的副本。(通常很難避免符合規定,但使用 Webpack 建構多個包含 Blockly 和 jsdom 的套件,然後將多個組合載入同一個 JavaScript 執行階段,才有可能在無意間受到禁止。如需實例示範,請參閱 https://github.com/google/blockly-samples/pull/1452#issuecomment-1364442135。)

textToDom(文字)

將 XML 字串轉換為 DOM 結構。

控製字元應逸出。(但我們會盡量剖析未逸出的字元)。

請注意,即使逸出後,U+0000 仍會剖析為 U+FFFD (「替換字元」),因為 U+0000 並非有效的 XML 字元 (即使在 XML 1.1 中也是如此)。https://www.w3.org/TR/xml11/#charsets

Variables

變數 說明
NAME_SPACE Blockly 的 XML 命名空間。