Class: Nokogiri::XML::DocumentFragment

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

Direct Known Subclasses

HTML::DocumentFragment

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(document, tags = nil, ctx = nil) ⇒ DocumentFragment

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+.


11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
# 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

Class Method Details

.new(document) ⇒ Object

Create a new DocumentFragment element on the document



9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
# File 'ext/nokogiri/xml_document_fragment.c', line 9

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);

  nokogiri_root_node(node);

  rb_node = Nokogiri_wrap_xml_node(klass, node);
  rb_obj_call_init(rb_node, argc, argv);

  if(rb_block_given_p()) rb_yield(rb_node);

  return rb_node;
}

.parse(tags) ⇒ Object

Create a Nokogiri::XML::DocumentFragment from tags



130
131
132
# File 'lib/nokogiri/xml/document_fragment.rb', line 130

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

Instance Method Details

#css(*args) ⇒ Object

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



94
95
96
97
98
99
100
# 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

#dupObject



30
31
32
33
34
35
36
37
# 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

#errorsObject

A list of Nokogiri::XML::SyntaxError found when parsing a document



136
137
138
# File 'lib/nokogiri/xml/document_fragment.rb', line 136

def errors
  document.errors
end

#errors=(things) ⇒ Object

:nodoc:



140
141
142
# File 'lib/nokogiri/xml/document_fragment.rb', line 140

def errors= things # :nodoc:
  document.errors = things
end

#nameObject

return the name for DocumentFragment



42
43
44
# File 'lib/nokogiri/xml/document_fragment.rb', line 42

def name
  '#document-fragment'
end

#search(*rules) ⇒ Object

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



113
114
115
116
117
118
119
120
121
122
123
# 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

#to_html(*args) ⇒ Object

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



55
56
57
58
59
60
61
62
63
64
# 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

#to_sObject Also known as: serialize

Convert this DocumentFragment to a string



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

def to_s
  children.to_s
end

#to_xhtml(*args) ⇒ Object

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



69
70
71
72
73
74
75
76
77
78
# 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

#to_xml(*args) ⇒ Object

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



83
84
85
# File 'lib/nokogiri/xml/document_fragment.rb', line 83

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