class Nokogiri::XML::DocumentFragment
DocumentFragment
represents a DocumentFragment
node in an xml document.
Public Class Methods
Create a new DocumentFragment
element on the document
static VALUE new (int argc, VALUE *argv, VALUE klass) { xmlDocPtr xml_doc; xmlNodePtr node; VALUE document; VALUE rest; VALUE rb_node; rb_scan_args(argc, argv, "1*", &document, &rest); Data_Get_Struct(document, xmlDoc, xml_doc); node = xmlNewDocFragment(xml_doc->doc); noko_xml_document_pin_node(node); rb_node = noko_xml_node_wrap(klass, node); rb_obj_call_init(rb_node, argc, argv); if (rb_block_given_p()) { rb_yield(rb_node); } return rb_node; }
Create a new DocumentFragment
from tags
.
If ctx
is present, it is used as a context node for the subtree created, e.g., namespaces will be resolved relative to ctx
.
# File lib/nokogiri/xml/document_fragment.rb, line 11 def initialize document, tags = nil, ctx = nil return self unless tags children = if ctx # Fix for issue#490 if Nokogiri.jruby? # fix for issue #770 ctx.parse("<root #{namespace_declarations(ctx)}>#{tags}</root>").children else ctx.parse(tags) end else XML::Document.parse("<root>#{tags}</root>") \ .xpath("/root/node()") end children.each { |child| child.parent = self } end
Create a Nokogiri::XML::DocumentFragment
from tags
# File lib/nokogiri/xml/document_fragment.rb, line 130 def parse tags self.new(XML::Document.new, tags) end
Public Instance Methods
Search this fragment for CSS
rules
. rules
must be one or more CSS
selectors. For example:
For more information see Nokogiri::XML::Searchable#css
# File lib/nokogiri/xml/document_fragment.rb, line 94 def css *args if children.any? children.css(*args) # 'children' is a smell here else NodeSet.new(document) end end
# File lib/nokogiri/xml/document_fragment.rb, line 30 def dup new_document = document.dup new_fragment = self.class.new(new_document) children.each do |child| child.dup(1, new_document).parent = new_fragment end new_fragment end
A list of Nokogiri::XML::SyntaxError
found when parsing a document
# File lib/nokogiri/xml/document_fragment.rb, line 136 def errors document.errors end
# File lib/nokogiri/xml/document_fragment.rb, line 144 def fragment(data) document.fragment(data) end
return the name for DocumentFragment
# File lib/nokogiri/xml/document_fragment.rb, line 42 def name '#document-fragment' end
Search this fragment for paths
. paths
must be one or more XPath
or CSS
queries.
For more information see Nokogiri::XML::Searchable#search
# File lib/nokogiri/xml/document_fragment.rb, line 113 def search *rules rules, handler, ns, binds = extract_params(rules) rules.inject(NodeSet.new(document)) do |set, rule| set += if rule =~ Searchable::LOOKS_LIKE_XPATH xpath(*([rule, ns, handler, binds].compact)) else children.css(*([rule, ns, handler].compact)) # 'children' is a smell here end end end
Convert this DocumentFragment
to html See Nokogiri::XML::NodeSet#to_html
# File lib/nokogiri/xml/document_fragment.rb, line 55 def to_html *args if Nokogiri.jruby? options = args.first.is_a?(Hash) ? args.shift : {} if !options[:save_with] options[:save_with] = Node::SaveOptions::NO_DECLARATION | Node::SaveOptions::NO_EMPTY_TAGS | Node::SaveOptions::AS_HTML end args.insert(0, options) end children.to_html(*args) end
Convert this DocumentFragment
to a string
# File lib/nokogiri/xml/document_fragment.rb, line 48 def to_s children.to_s end
Convert this DocumentFragment
to xhtml See Nokogiri::XML::NodeSet#to_xhtml
# File lib/nokogiri/xml/document_fragment.rb, line 69 def to_xhtml *args if Nokogiri.jruby? options = args.first.is_a?(Hash) ? args.shift : {} if !options[:save_with] options[:save_with] = Node::SaveOptions::NO_DECLARATION | Node::SaveOptions::NO_EMPTY_TAGS | Node::SaveOptions::AS_XHTML end args.insert(0, options) end children.to_xhtml(*args) end
Convert this DocumentFragment
to xml See Nokogiri::XML::NodeSet#to_xml
# File lib/nokogiri/xml/document_fragment.rb, line 83 def to_xml *args children.to_xml(*args) end
Private Instance Methods
fix for issue 770
# File lib/nokogiri/xml/document_fragment.rb, line 151 def namespace_declarations ctx ctx.namespace_scopes.map do |namespace| prefix = namespace.prefix.nil? ? "" : ":#{namespace.prefix}" %Q{xmlns#{prefix}="#{namespace.href}"} end.join ' ' end