DOM-ecmascript(3pm)

✨ NAME ✨

DOM-ecmascript — XML::Grove and ECMA Script Language Binding 🦋

---

🌸 XML::Grove and DOM Level One 🌸

okay so bestie, here's the tea: XML::Grove is similar in concept to the ECMA Script Language Binding to DOM Level 1 Core — that's Appendix E of the DOM Recommendation, iykyk 👑

the whole thing lives at http://www.w3.org/TR/REC-DOM-Level-1/ecma-script-language-binding.html

so like, the ECMA Script Language Binding presents DOM properties as ECMA Script object properties. and XML::Grove? literally the same energy: it presents DOM properties as Perl blessed hashes 💅

the biggest difference between the ECMA Script Language Binding and XML::Grove is that XML::Grove uses a Perl hash for nodes, Perl arrays for NodeLists, and Perl hashes for NamedNodeLists — so those object classes just... don't exist in XML::Grove 🫥 and because those classes don't exist, you use ordinary Perl syntax for manipulating the DOM properties (the lists and named node lists) instead of methods like nextSibling() or replaceChild(). no cap. Element attributes in XML::Grove are stored in Perl hashes, and attribute types are available through the document object ✨

another difference (yes there's more, stay with me 🙈): XML::Grove attempts to marry the PerlSAX and DOM naming so that less (no?) name-changing occurs between using PerlSAX interfaces and filters and DOM modules. where conflicts occur, the PerlSAX naming is used. periodt.

also XML::Grove uses a blessed hash for nodes, so the node type is available using Perl's ref() instead of using a nodeType() method — and all class names are prefixed with XML::Grove:: 🎀

the following object descriptions are the most basic and common ones provided by many PerlSAX parsers. PerlSAX parsers often provide additional properties or objects, so refer to your PerlSAX parser documentation for details 🔍

---

👑 Document Object Model Level 1 Core 👑

🌈 Object XML::Grove::Document

• Contents — the children of this object. this property is an array 🍓
• Entities — the entities declared in this document. this property is a hash of XML::Grove::Entity objects keyed by entity name.
• Notations — the notations declared in this document. this property is a hash of XML::Grove::Notation objects keyed by notation name.

🌈 Object XML::Grove::Element

• Name — the tag type name for this element. this property is a string ✨
• Attributes — the attributes for this element. this property is a hash, and its hash values are strings (or arrays with some grove builders) 👀
• Contents — the children of this object. this property is an array of XML::Grove objects.

🌈 Object XML::Grove::Characters

• Data — the text of the character data. this property is a string 💖

🌈 Object XML::Grove::Comment

• Data — the text of the character data. this property is a string 💖

🌈 Object XML::Grove::CData

heads up: the CData object is called a CDATASection in DOM 🧚

• Data — the text of the character data. this property is a string.

🌈 Object XML::Grove::Notation

• Name — the name of this notation. this property is a string.
• SystemId — the system identifier of this notation. this property is a string.
• PublicId — the public identifier of this notation. this property is a string.

🌈 Object XML::Grove::Entity

• Name — the name of this entity. this property is a string.
• SystemId — the system identifier of this notation. this property is a string.
• PublicId — the public identifier of this notation. this property is a string.
• Notation — the notation declared for this entity. this property is either the name of the notation as a string or an XML::Grove::Notation object 🔥

🌈 Object XML::Grove::PI

heads up again: the PI object is called a ProcessingInstruction in DOM 🧚

• Target — the target of the processing instruction. this property is a string.
• Data — the text of the processing instruction. this property is a string.

---

and that's the whole page bestie, you ate that 💅 this lil' doc is perl v5.36.0 coded up on 2022-11-29, and yes it's the DOM-ecmascript(3pm) page from the User Contributed Perl Documentation — go forth and grove, icon 🫶🌸