blockly > utils > xml

מרחב השמות utils.xml

פונקציות

פעולה התיאור
createElement(tagName) יצירת רכיב DOM עבור XML.
createTextNode(text) יוצרים רכיב טקסט ל-XML.
domToText(dom)

ממירה מבנה DOM לטקסט פשוט. כרגע תבנית הטקסט מכוערת למדי: שורה אחת ללא רווח לבן.

תווי הבקרה יסומנו בתו בריחה (escape) באמצעות הקידוד העשרוני שלהם. הערך כולל U+0000 למרות שטכנית הוא אף פעם לא תו XML חוקי (גם ב-XML 1.1 ). https://www.w3.org/TR/xml11/#charsets

כאשר U+0000 מפוענח, מנותח כ-U+FFFD ("תו ההחלפה").

injectDependencies(dependencies)

הזרקת יישומים של מסמכים, DOMParser ו/או XMLSerializer לשימוש במקום יישומי ברירת המחדל.

משמש ב-wrapper של Node.js ל-Blockly (ניתן לעיין ב-Script/package/node/core.js) כדי לספק יישומים מחבילת jsdom במקום זאת.

אף שניתן להגדיר אותם בנפרד, בדרך כלל רוב השלושה יגיעו מאותו מופע JSDOM. הם חייבים להגיע לפחות מאותו עותק של חבילת jsdom. (בדרך כלל קשה להימנע מעמידה בדרישה הזו, אבל ייתכן שלפעמים תפרו אותה בטעות על ידי שימוש ב-webpack כדי לבנות חבילות מרובות שכוללות אתBlockly ו-jsdom, ולאחר מכן לטעון יותר מחבילה אחת באותו זמן ריצה של JavaScript. בכתובת https://github.com/google/blockly-samples/pull/1452#issuecomment-1364442135 תוכל לראות דוגמה לכך).

textToDom(text)

ממירה מחרוזת XML למבנה DOM.

יש לסמן תווי בקרה בתו בריחה (escape). (אבל ננסה לנתח ככל האפשר תווים ללא escape.)

חשוב לשים לב שגם אם משתמשים בתווי הבריחה (escape), U+0000 ינותח כ-U+FFFD (תו ההחלפה), כי U+0000 אף פעם אינו תו XML חוקי (גם ב-XML מגרסה 1.1). https://www.w3.org/TR/xml11/#charsets

משתנים

משתנה התיאור
NAME_SPACE מרחב שמות ל-XML של blockly.