module Nokogiri
module XML
class DocumentFragment < Nokogiri::XML::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+.
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("#{tags}").children
else
ctx.parse(tags)
end
else
XML::Document.parse("#{tags}") \
.xpath("/root/node()")
end
children.each { |child| child.parent = self }
end
###
# return the name for DocumentFragment
def name
'#document-fragment'
end
###
# Convert this DocumentFragment to a string
def to_s
children.to_s
end
###
# Convert this DocumentFragment to html
# See Nokogiri::XML::NodeSet#to_html
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 xhtml
# See Nokogiri::XML::NodeSet#to_xhtml
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
def to_xml *args
children.to_xml(*args)
end
###
# call-seq: css *rules, [namespace-bindings, custom-pseudo-class]
#
# Search this fragment for CSS +rules+. +rules+ must be one or more CSS
# selectors. For example:
#
# For more information see Nokogiri::XML::Searchable#css
def css *args
if children.any?
children.css(*args) # 'children' is a smell here
else
NodeSet.new(document)
end
end
#
# NOTE that we don't delegate #xpath to children ... another smell.
# def xpath ; end
#
###
# call-seq: search *paths, [namespace-bindings, xpath-variable-bindings, custom-handler-class]
#
# Search this fragment for +paths+. +paths+ must be one or more XPath or CSS queries.
#
# For more information see Nokogiri::XML::Searchable#search
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
alias :serialize :to_s
class << self
####
# Create a Nokogiri::XML::DocumentFragment from +tags+
def parse tags
self.new(XML::Document.new, tags)
end
end
# A list of Nokogiri::XML::SyntaxError found when parsing a document
def errors
document.errors
end
def errors= things # :nodoc:
document.errors = things
end
private
# fix for issue 770
def namespace_declarations ctx
ctx.namespace_scopes.map do |namespace|
prefix = namespace.prefix.nil? ? "" : ":#{namespace.prefix}"
%Q{xmlns#{prefix}="#{namespace.href}"}
end.join ' '
end
def coerce data
return super unless String === data
document.fragment(data).children
end
end
end
end