Sha256: 93e3e29e60a146482ccc75aac353fe36263a6459dd92914f0034cea79a911d28

Contents?: true

Size: 1.76 KB

Versions: 111

Compression:

Stored size: 1.76 KB

Contents

# frozen_string_literal: true

module Nokogiri
  module HTML4
    ###
    # Nokogiri provides a SAX parser to process HTML4 which will provide HTML recovery
    # ("autocorrection") features.
    #
    # See Nokogiri::HTML4::SAX::Parser for a basic example of using a SAX parser with HTML.
    #
    # For more information on SAX parsers, see Nokogiri::XML::SAX
    #
    module SAX
      ###
      # This parser is a SAX style parser that reads its input as it deems necessary. The parser
      # takes a Nokogiri::XML::SAX::Document, an optional encoding, then given an HTML input, sends
      # messages to the Nokogiri::XML::SAX::Document.
      #
      # ⚠ This is an HTML4 parser and so may not support some HTML5 features and behaviors.
      #
      # Here is a basic usage example:
      #
      #   class MyHandler < Nokogiri::XML::SAX::Document
      #     def start_element name, attributes = []
      #       puts "found a #{name}"
      #     end
      #   end
      #
      #   parser = Nokogiri::HTML4::SAX::Parser.new(MyHandler.new)
      #
      #   # Hand an IO object to the parser, which will read the HTML from the IO.
      #   File.open(path_to_html) do |f|
      #     parser.parse(f)
      #   end
      #
      # For more information on \SAX parsers, see Nokogiri::XML::SAX or the parent class
      # Nokogiri::XML::SAX::Parser.
      #
      # Also see Nokogiri::XML::SAX::Document for the available events.
      #
      class Parser < Nokogiri::XML::SAX::Parser
        # this class inherits its behavior from Nokogiri::XML::SAX::Parser, but note that superclass
        # uses Nokogiri::ClassResolver to use HTML4::SAX::ParserContext as the context class for
        # this class, which is where the real behavioral differences are implemented.
      end
    end
  end
end

Version data entries

111 entries across 111 versions & 2 rubygems

Version Path
nokogiri-1.18.5-x86_64-linux-musl lib/nokogiri/html4/sax/parser.rb
nokogiri-1.18.5-x86_64-linux-gnu lib/nokogiri/html4/sax/parser.rb
nokogiri-1.18.5-x86_64-darwin lib/nokogiri/html4/sax/parser.rb
nokogiri-1.18.5-x64-mingw-ucrt lib/nokogiri/html4/sax/parser.rb
nokogiri-1.18.5-java lib/nokogiri/html4/sax/parser.rb
nokogiri-1.18.5 lib/nokogiri/html4/sax/parser.rb
nokogiri-1.18.5-arm-linux-musl lib/nokogiri/html4/sax/parser.rb
nokogiri-1.18.5-arm-linux-gnu lib/nokogiri/html4/sax/parser.rb
nokogiri-1.18.5-arm64-darwin lib/nokogiri/html4/sax/parser.rb
nokogiri-1.18.5-aarch64-linux-musl lib/nokogiri/html4/sax/parser.rb
nokogiri-1.18.5-aarch64-linux-gnu lib/nokogiri/html4/sax/parser.rb
nokogiri-1.18.4-x86_64-linux-musl lib/nokogiri/html4/sax/parser.rb
nokogiri-1.18.4-x86_64-linux-gnu lib/nokogiri/html4/sax/parser.rb
nokogiri-1.18.4-x86_64-darwin lib/nokogiri/html4/sax/parser.rb
nokogiri-1.18.4-x64-mingw-ucrt lib/nokogiri/html4/sax/parser.rb
nokogiri-1.18.4-java lib/nokogiri/html4/sax/parser.rb
nokogiri-1.18.4 lib/nokogiri/html4/sax/parser.rb
nokogiri-1.18.4-arm-linux-musl lib/nokogiri/html4/sax/parser.rb
nokogiri-1.18.4-arm-linux-gnu lib/nokogiri/html4/sax/parser.rb
nokogiri-1.18.4-arm64-darwin lib/nokogiri/html4/sax/parser.rb