Class: Nokogiri::XML::DocumentFragment

Inherits:
Node
  • Object
show all
Defined in:
lib/nokogiri/xml/document_fragment.rb,
lib/nokogiri/ffi/xml/document_fragment.rb,
ext/nokogiri/xml_document_fragment.c

Direct Known Subclasses

HTML::DocumentFragment

Constant Summary

Constants inherited from Node

Node::ATTRIBUTE_DECL, Node::ATTRIBUTE_NODE, Node::CDATA_SECTION_NODE, Node::COMMENT_NODE, Node::DOCB_DOCUMENT_NODE, Node::DOCUMENT_FRAG_NODE, Node::DOCUMENT_NODE, Node::DOCUMENT_TYPE_NODE, Node::DTD_NODE, Node::ELEMENT_DECL, Node::ELEMENT_NODE, Node::ENTITY_DECL, Node::ENTITY_NODE, Node::ENTITY_REF_NODE, Node::HTML_DOCUMENT_NODE, Node::NAMESPACE_DECL, Node::NOTATION_NODE, Node::PI_NODE, Node::TEXT_NODE, Node::XINCLUDE_END, Node::XINCLUDE_START

Instance Attribute Summary

Attributes inherited from Node

#cstruct

Class Method Summary collapse

Instance Method Summary collapse

Methods inherited from Node

#<=>, #==, #>, #[], #[]=, #accept, #add_child, #add_namespace, #add_namespace_definition, #add_next_sibling, #add_previous_sibling, #after, #ancestors, #at, #at_css, #at_xpath, #attribute, #attribute_nodes, #attribute_with_ns, #attributes, #before, #blank?, #cdata?, #child, #children, #clone, #comment?, #content, #content=, #create_external_subset, #create_internal_subset, #css_path, #decorate!, #default_namespace=, #description, #document, #dup, #each, #element?, #encode_special_chars, #external_subset, #fragment, #has_attribute?, #html?, #inner_html, #inner_html=, #inner_text, #internal_subset, #key?, #keys, #line, #matches?, #name=, #namespace, #namespace=, #namespace_definitions, #namespaced_key?, #namespaces, #next, #next_element, #next_sibling, #node_name, #node_name=, node_properties, #node_type, #parent, #parent=, #path, #pointer_id, #previous, #previous_element, #previous_sibling, #read_only?, #remove, #remove_attribute, #replace, #search, #set_attribute, #swap, #text, #text?, #traverse, #type, #unlink, #values, wrap, #write_html_to, #write_to, #write_xhtml_to, #write_xml_to, #xml?, #xpath

Methods included from PP::Node

#inspect, #pretty_print

Constructor Details

#initialize(document, tags = nil) ⇒ DocumentFragment

Returns a new instance of DocumentFragment.



4
5
6
7
8
9
10
11
12
13
14
15
16
# File 'lib/nokogiri/xml/document_fragment.rb', line 4

def initialize document, tags=nil
  if tags
    if self.kind_of?(Nokogiri::HTML::DocumentFragment)
      HTML::SAX::Parser.new(FragmentHandler.new(self, tags)).parse(tags)
    else
      wrapped = "<div>#{tags.strip}</div>"
      XML::SAX::Parser.new(FragmentHandler.new(self, wrapped)).parse(wrapped)
      div = self.child
      div.children.each { |child| child.parent = self }
      div.unlink
    end
  end
end

Class Method Details

.new(document) ⇒ Object

Create a new DocumentFragment element on the document



5
6
7
8
9
10
11
12
13
14
15
16
# File 'lib/nokogiri/ffi/xml/document_fragment.rb', line 5

def self.new(document, *rest) # :nodoc:
  node_ptr = LibXML.xmlNewDocFragment(document.cstruct)
  node_cstruct = LibXML::XmlNode.new(node_ptr)
  node_cstruct.keep_reference_from_document!

  node = Node.wrap(node_cstruct, self)

  node.send :initialize, document, *rest
  yield node if block_given?

  node
end

.parse(tags) ⇒ Object

Create a Nokogiri::XML::DocumentFragment from tags



66
67
68
# File 'lib/nokogiri/xml/document_fragment.rb', line 66

def parse tags
  self.new(XML::Document.new, tags)
end

Instance Method Details

#css(*args) ⇒ Object

Search this fragment. See Nokogiri::XML::Node#css



53
54
55
56
57
58
59
# File 'lib/nokogiri/xml/document_fragment.rb', line 53

def css *args
  if children.any?
    children.css(*args)
  else
    NodeSet.new(document)
  end
end

#nameObject

return the name for DocumentFragment



20
21
22
# File 'lib/nokogiri/xml/document_fragment.rb', line 20

def name
  '#document-fragment'
end

#to_html(*args) ⇒ Object

Convert this DocumentFragment to html See Nokogiri::XML::NodeSet#to_html



33
34
35
# File 'lib/nokogiri/xml/document_fragment.rb', line 33

def to_html *args
  children.to_html(*args)
end

#to_sObject Also known as: serialize

Convert this DocumentFragment to a string



26
27
28
# File 'lib/nokogiri/xml/document_fragment.rb', line 26

def to_s
  children.to_s
end

#to_xhtml(*args) ⇒ Object

Convert this DocumentFragment to xhtml See Nokogiri::XML::NodeSet#to_xhtml



40
41
42
# File 'lib/nokogiri/xml/document_fragment.rb', line 40

def to_xhtml *args
  children.to_xhtml(*args)
end

#to_xml(*args) ⇒ Object

Convert this DocumentFragment to xml See Nokogiri::XML::NodeSet#to_xml



47
48
49
# File 'lib/nokogiri/xml/document_fragment.rb', line 47

def to_xml *args
  children.to_xml(*args)
end