Sha256: 2829853ed124328ec95ca9771f75edb0ee1a65b9239ad978ac33f99050cb8a60

Contents?: true

Size: 1.36 KB

Versions: 23

Compression:

Stored size: 1.36 KB

Contents

# HTML check API

For checking HTML elements in `.liquid` files.

If you need to check an HTML tag or its attributes, use an `HtmlCheck`.

The HTML in Liquid files is parsed using the Nokogiri, by consequence you will get [`Nokogiri::XML::Node`][nokogiri].


```ruby
module PlatformosCheck
  class MyCheckName < HtmlCheck
    category :html,
    # A check can belong to multiple categories. Valid ones:
    categories :translation, :performance
    severity :suggestion # :error or :style

    def on_document(node)
      # Called with the root node of all theme files
      node.value      # is an instance of Nokogiri::XML::Node
      node.app_file # is the html_file being analyzed, See lib/platformos_check/app_file.rb.
      node.parent     # is the parent node.
      node.children   # are the children nodes.
      # See lib/platformos_check/html_node.rb for more helper methods
      theme # Gives you access to all the theme files in the theme. See lib/platformos_check/theme.rb.
    end

    def on_img(node)
      # Called for every <img> element in the file.
      node.attributes["class"] # Get the class attribute of the img element.
    end

    def on_a(node)
      # Called for every <a> element in the file.
    end
  end
end
```

## Resources

- [Nokogiri::XML::Node API doc][nokogiri]

[nokogiri]: https://www.rubydoc.info/github/sparklemotion/nokogiri/Nokogiri/XML/Node


Version data entries

23 entries across 23 versions & 1 rubygems

Version Path
platformos-check-0.4.12 docs/api/html_check.md
platformos-check-0.4.11 docs/api/html_check.md
platformos-check-0.4.10 docs/api/html_check.md
platformos-check-0.4.9 docs/api/html_check.md
platformos-check-0.4.8 docs/api/html_check.md
platformos-check-0.4.7 docs/api/html_check.md
platformos-check-0.4.6 docs/api/html_check.md
platformos-check-0.4.5 docs/api/html_check.md
platformos-check-0.4.4 docs/api/html_check.md
platformos-check-0.4.3 docs/api/html_check.md
platformos-check-0.4.2 docs/api/html_check.md
platformos-check-0.4.1 docs/api/html_check.md
platformos-check-0.4.0 docs/api/html_check.md
platformos-check-0.3.3 docs/api/html_check.md
platformos-check-0.3.1 docs/api/html_check.md
platformos-check-0.3.0 docs/api/html_check.md
platformos-check-0.2.2 docs/api/html_check.md
platformos-check-0.2.1 docs/api/html_check.md
platformos-check-0.2.0 docs/api/html_check.md
platformos-check-0.1.0 docs/api/html_check.md