module Nokogiri::HTML5::Node - nokogiri-1.15.2 Documentation

# module Nokogiri::HTML5::Node

Since v1.12.0

💡 `HTML5` functionality is not available when running JRuby.

### Public Instance Methods

fragment(tags) click to toggle source
Calls superclass method

    # 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 = {}) click to toggle source
Calls superclass method

    # 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| ... } click to toggle source
Calls superclass method

    # 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

### Private Instance Methods

add_child_node_and_reparent_attrs(node) click to toggle source

`HTML` elements can have attributes that contain colons. `Nokogiri::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.

Calls superclass method

    # 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