Class: Dommy::DOMImplementation

Inherits:

Object

Object
Dommy::DOMImplementation

show all

Includes:: Bridge::Methods

Defined in:: lib/dommy/document.rb

Overview

document.implementation — the DOMImplementation.

Instance Method Summary collapse

#__js_call__(method, args) ⇒ Object
#__js_get__(_key) ⇒ Object
method-only; any property read is absent.
#create_document(namespace, qualified_name, doctype = nil) ⇒ Object
createDocument(namespace, qualifiedName, doctype?) — a fresh XML document with, in tree order, the doctype (when given) then a document element (namespace, qualifiedName) when qualifiedName is non-empty.
#create_document_type(qualified_name, public_id, system_id) ⇒ Object
A created DocumentType's node document is the implementation's document.
#create_html_document(title = nil) ⇒ Object
createHTMLDocument(title?) — a fresh HTML document (doctype + html > head, body), with an optional .</div> </li> <li class="public "> <a href="#has_feature-instance_method" title="#has_feature (instance method)">#has_feature ⇒ Object </a> <div class='inline'><code>hasFeature()</code> is a no-op that always returns true (DOM Standard).</div> </li> <li class="public "> <a href="#initialize-instance_method" title="#initialize (instance method)">#initialize(document) ⇒ DOMImplementation </a> constructor <div class='inline'>A new instance of DOMImplementation.</div> </li> </ul> <h3 class="inherited">Methods included from <a href="Bridge/Methods.html" title="Dommy::Bridge::Methods (module)">Bridge::Methods</a></h3> <a href="Bridge/Methods.html#included-class_method" title="Dommy::Bridge::Methods.included (method)">included</a> <div id="constructor_details" class="method_details_list"> <h2>Constructor Details</h2> <div class="method_details first"> <h3 class="signature first" id="initialize-instance_method"> #initialize(document) ⇒ <tt><a href="" title="Dommy::DOMImplementation (class)">DOMImplementation</a></tt> </h3><div class="docstring"> <div class="discussion"> Returns a new instance of DOMImplementation. </div> </div> <div class="tags"> </div><table class="source_code"> <tr> <td> <pre class="lines"> 230 231 232</pre> </td> <td> <pre class="code"># File 'lib/dommy/document.rb', line 230 def initialize(document) @document = document end</pre> </td> </tr> </table> </div> </div> <div id="instance_method_details" class="method_details_list"> <h2>Instance Method Details</h2> <div class="method_details first"> <h3 class="signature first" id="__js_call__-instance_method"> #__js_call__(method, args) ⇒ <tt>Object</tt> </h3><table class="source_code"> <tr> <td> <pre class="lines"> 322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338 339</pre> </td> <td> <pre class="code"># File 'lib/dommy/document.rb', line 322 def __js_call__(method, args) case method when "createDocumentType" create_document_type(args[0], args[1], args[2]) when "createDocument" create_document(args[0], args[1], args[2]) when "createHTMLDocument" # title is an OPTIONAL DOMString: a missing or undefined argument leaves # the document title-less, but an explicit null coerces to "null". if args.empty? || args[0].equal?(<a href="Bridge.html" title="Dommy::Bridge (module)">Bridge</a>::<a href="Bridge.html#UNDEFINED-constant" title="Dommy::Bridge::UNDEFINED (constant)">UNDEFINED</a>) create_html_document else create_html_document(args[0].nil? ? "null" : args[0]) end when "hasFeature" has_feature end end</pre> </td> </tr> </table> </div> <div class="method_details "> <h3 class="signature " id="__js_get__-instance_method"> #__js_get__(_key) ⇒ <tt>Object</tt> </h3><div class="docstring"> <div class="discussion"> method-only; any property read is absent </div> </div> <div class="tags"> </div><table class="source_code"> <tr> <td> <pre class="lines"> 318</pre> </td> <td> <pre class="code"># File 'lib/dommy/document.rb', line 318 def __js_get__(_key) = <a href="Bridge.html" title="Dommy::Bridge (module)">Bridge</a>::<a href="Bridge.html#ABSENT-constant" title="Dommy::Bridge::ABSENT (constant)">ABSENT</a> # method-only; any property read is absent</pre> </td> </tr> </table> </div> <div class="method_details "> <h3 class="signature " id="create_document-instance_method"> #create_document(namespace, qualified_name, doctype = nil) ⇒ <tt>Object</tt> </h3><div class="docstring"> <div class="discussion"> createDocument(namespace, qualifiedName, doctype?) — a fresh XML document with, in tree order, the doctype (when given) then a document element (namespace, qualifiedName) when qualifiedName is non-empty. </div> </div> <div class="tags"> </div><table class="source_code"> <tr> <td> <pre class="lines"> 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281</pre> </td> <td> <pre class="code"># File 'lib/dommy/document.rb', line 262 def create_document(namespace, qualified_name, doctype = nil) doc = <a href="Document.html" title="Dommy::Document (class)">Document</a>.<a href="Document.html#initialize-instance_method" title="Dommy::Document#initialize (method)">new</a>(nil, backend_doc: <a href="Backend.html" title="Dommy::Backend (module)">Backend</a>.<a href="Backend.html#empty_xml_document-class_method" title="Dommy::Backend.empty_xml_document (method)">empty_xml_document</a>) # createDocument's content type is keyed off the namespace. None is # "text/html", so tagName keeps its case; xhtml+xml still routes # createElement to the HTML namespace (so an XHTML document isEqualNode # an HTML one). doc.content_type = case namespace.to_s when <a href="Internal.html" title="Dommy::Internal (module)">Internal</a>::<a href="Internal/Namespaces.html" title="Dommy::Internal::Namespaces (module)">Namespaces</a>::<a href="Internal/Namespaces.html#HTML-constant" title="Dommy::Internal::Namespaces::HTML (constant)">HTML</a> then "application/xhtml+xml" when <a href="Internal.html" title="Dommy::Internal (module)">Internal</a>::<a href="Internal/Namespaces.html" title="Dommy::Internal::Namespaces (module)">Namespaces</a>::<a href="Internal/Namespaces.html#SVG-constant" title="Dommy::Internal::Namespaces::SVG (constant)">SVG</a> then "image/svg+xml" else "application/xml" end qn = qualified_name.to_s unless qn.empty? el = doc.send(:create_element_ns, namespace, qualified_name) <a href="Backend.html" title="Dommy::Backend (module)">Backend</a>.<a href="Backend.html#set_document_root-class_method" title="Dommy::Backend.set_document_root (method)">set_document_root</a>(doc.backend_doc, el.__dommy_backend_node__) end adopt_doctype_into(doc, doctype) doc end</pre> </td> </tr> </table> </div> <div class="method_details "> <h3 class="signature " id="create_document_type-instance_method"> #create_document_type(qualified_name, public_id, system_id) ⇒ <tt>Object</tt> </h3><div class="docstring"> <div class="discussion"> A created DocumentType's node document is the implementation's document. When the backend ships a doctype factory (the HTML backend) and accepts the name, the result is a real, node-backed (but detached) DocumentType that can join the tree; otherwise it falls back to a synthetic one. (Qualified-name QName validation isn't enforced — createDocumentType is permissive, so the factory's stricter name check is bypassed via the synthetic fallback rather than raising; a couple of invalid-name WPT cases stay documented gaps.) </div> </div> <div class="tags"> </div><table class="source_code"> <tr> <td> <pre class="lines"> 241 242 243 244 245 246 247 248 249 250 251 252</pre> </td> <td> <pre class="code"># File 'lib/dommy/document.rb', line 241 def create_document_type(qualified_name, public_id, system_id) qn = qualified_name.to_s pub = public_id.to_s sys = system_id.to_s node = begin <a href="Backend.html" title="Dommy::Backend (module)">Backend</a>.<a href="Backend.html#create_document_type-class_method" title="Dommy::Backend.create_document_type (method)">create_document_type</a>(qn, pub, sys, @document.backend_doc) rescue ArgumentError nil end node ? <a href="DocumentType.html" title="Dommy::DocumentType (class)">DocumentType</a>.<a href="DocumentType.html#initialize-instance_method" title="Dommy::DocumentType#initialize (method)">new</a>(backend_node: node, document: @document) : <a href="DocumentType.html" title="Dommy::DocumentType (class)">DocumentType</a>.<a href="DocumentType.html#initialize-instance_method" title="Dommy::DocumentType#initialize (method)">new</a>(qn, pub, sys, owner_document: @document) end</pre> </td> </tr> </table> </div> <div class="method_details "> <h3 class="signature " id="create_html_document-instance_method"> #create_html_document(title = nil) ⇒ <tt>Object</tt> </h3><div class="docstring"> <div class="discussion"> createHTMLDocument(title?) — a fresh HTML document (doctype + html > head, body), with an optional <title>. </div> </div> <div class="tags"> </div><table class="source_code"> <tr> <td> <pre class="lines"> 312 313 314 315 316</pre> </td> <td> <pre class="code"># File 'lib/dommy/document.rb', line 312 def create_html_document(title = nil) doc = <a href="Document.html" title="Dommy::Document (class)">Document</a>.<a href="Document.html#initialize-instance_method" title="Dommy::Document#initialize (method)">new</a>(nil, backend_doc: <a href="Backend.html" title="Dommy::Backend (module)">Backend</a>.<a href="Backend.html#parse-class_method" title="Dommy::Backend.parse (method)">parse</a>("<!DOCTYPE html><html><head></head><body></body></html>")) doc.title = title.to_s unless title.nil? || title.equal?(<a href="Bridge.html" title="Dommy::Bridge (module)">Bridge</a>::<a href="Bridge.html#UNDEFINED-constant" title="Dommy::Bridge::UNDEFINED (constant)">UNDEFINED</a>) doc end</pre> </td> </tr> </table> </div> <div class="method_details "> <h3 class="signature " id="has_feature-instance_method"> #has_feature ⇒ <tt>Object</tt> </h3><div class="docstring"> <div class="discussion"> <code>hasFeature()</code> is a no-op that always returns true (DOM Standard). </div> </div> <div class="tags"> </div><table class="source_code"> <tr> <td> <pre class="lines"> 255 256 257</pre> </td> <td> <pre class="code"># File 'lib/dommy/document.rb', line 255 def has_feature(*) true end</pre> </td> </tr> </table> </div> </div> </div> <div id="footer"> Generated on Mon Jul 13 13:57:01 2026 by <a href="https://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a> 0.9.44 (ruby-4.0.2). </div> </div> </body> </html>