Module: Nokogiri::HTML5::Node

Relationships & Source Files
Extension / Inclusion / Inheritance Descendants
Included In: `::Nokogiri::HTML5`
Defined in:	lib/nokogiri/html5/node.rb

Overview

Since v1.12.0

💡 ::Nokogiri::HTML5 functionality is not available when running JRuby.

Instance Method Summary

#fragment(tags)
#inner_html(options = {})
#write_to(io, *options) {|config| ... }
#add_child_node_and_reparent_attrs(node) private

::Nokogiri::HTML elements can have attributes that contain colons.

Instance Method Details

#add_child_node_and_reparent_attrs(node) (private)

::Nokogiri::HTML elements can have attributes that contain colons. XML::Node#[]= treats names with colons as a prefixed QName and tries to create an attribute in a namespace. This is especially annoying with attribute names like xml:lang since libxml2 will actually create the xml namespace if it doesn’t exist already.

[ GitHub ]

# File 'lib/nokogiri/html5/node.rb', line 83


def add_child_node_and_reparent_attrs(node)
  return super(node) unless document.is_a?(HTML5::Document)

  # I'm not sure what this method is supposed to do. Reparenting
  # namespaces is handled by libxml2, including child namespaces which
  # this method wouldn't handle.
  # https://github.com/sparklemotion/nokogiri/issues/1790
  add_child_node(node)
  # node.attribute_nodes.find_all { |a| a.namespace }.each do |attr|
  #  attr.remove
  #  ns = attr.namespace
  #  a["#{ns.prefix}:#{attr.name}"] = attr.value
  # end
end

#fragment(tags)

[ GitHub ]

# File 'lib/nokogiri/html5/node.rb', line 70


def fragment(tags)
  return super(tags) unless document.is_a?(HTML5::Document)

  DocumentFragment.new(document, tags, self)
end

#inner_html(options = {})

[ GitHub ]

# File 'lib/nokogiri/html5/node.rb', line 31


def inner_html(options = {})
  return super(options) unless document.is_a?(HTML5::Document)

  result = options[:preserve_newline] && prepend_newline? ? +"\n" : +""
  result << children.map { |child| child.to_html(options) }.join
  result
end

#write_to(io, *options) {|config| ... }

Yields:

(config)

[ GitHub ]

# File 'lib/nokogiri/html5/node.rb', line 39


def write_to(io, *options)
  return super(io, *options) unless document.is_a?(HTML5::Document)

  options = options.first.is_a?(Hash) ? options.shift : {}
  encoding = options[:encoding] || options[0]
  if Nokogiri.jruby?
    save_options = options[:save_with] || options[1]
    indent_times = options[:indent] || 0
  else
    save_options = options[:save_with] || options[1] || XML::Node::SaveOptions::FORMAT
    indent_times = options[:indent] || 2
  end
  indent_string = (options[:indent_text] || " ") * indent_times

  config = XML::Node::SaveOptions.new(save_options.to_i)
  yield config if block_given?

  encoding = encoding.is_a?(Encoding) ? encoding.name : encoding

  config_options = config.options
  if config_options & (XML::Node::SaveOptions::AS_XML | XML::Node::SaveOptions::AS_XHTML) != 0
    # Use Nokogiri's serializing code.
    native_write_to(io, encoding, indent_string, config_options)
  else
    # Serialize including the current node.
    html = html_standard_serialize(options[:preserve_newline] || false)
    encoding ||= document.encoding || Encoding::UTF_8
    io << html.encode(encoding, fallback: lambda { |c| "&#x#{c.ord.to_s(16)};" })
  end
end